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CHAPTER 1 



INTRODUCTION 



The EXORdisk II is s sing le— sided- sing le— densi ty, dual 
diskette drive storage system designed for use with the 
EXORciser or EXORterm. The EXORdisk III is a double-sided, 
single-density, dual diskette drive storage system designed 
for use with the EXORciser or EXORterm. The EXORdisk III can 
be expanded into a foui — drive system. 

With either the EXORdisk II or EXORdisk III system, the 
follou/ing items are also included: a floppy disk controller 
module, a floppy disk interconnection cable assembly, and a 
softiuare disk operating system. An illustration of a typical 
EXORdisk system is shown in Figure 1-1. 

The M6800 Diskette Operating System (MDOS) or M6809 
Diskette Operating System (MD0S09), in conjunction with the 
EXORciser and EXORdisk II or EXORdisk III, provides a 
powerful and easy— to— use tool for software development. For 
the remainder of this manual, ail references to MDOS will 
encompass both the M6800 version as well as the M6809 
version, unless otherwise specified. 

MDOS is an interactive operating system that obtains 
commands from the system console. These commands are used to 
move data on the diskette, to process data, or to activate 
user-written processes from diskette. All this can be 
accomplished with a minimum of effort; and since MDOS is a 
facilities oriented system, rather than a supervisory 
oriented one, a minimum of overhead is imposed. 

In addition, an extensive set of resident system 
functions are provided for general development use. Such 
functions as dynamic space allocation, random access to data 
files, record I/O for supported and non-supported devices, as 
well as many register, string, and other diskette-oriented 
routines make MDOS a good basis for a user's application 
system. 



Page 01-01 



J 



. ■ ^,LM I , l |J l jj_,.H jl _J I J. I .JJ.._,_^J 1 , 11 . 1 ^..1, 1 . J ..-J-.-, ' I ...-- ......._.. , ., .. . ■ 



:vV 



^'i:imBl?\~^ 




•^ •m^^-";'^^^ 



Figure 1-1. Typcial EXORdisk system. 
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INTRODUCTION 1- 1 — Hardware Support Required 

1. 1 Hardware Support Required 

The minimum hardware configuration required to support 
MDOS consists of: 

— an EXORciser or EXORterm with EXbug firmware 

— 16K RAM 

— EXQRdisk II/III dual diskette drive unit 

— EXQRdisk II/III floppy disk controller module 

— Interconnect cable 

— ASR33 <TTY) or RS-232C compatible terminal 

The EXQRdisk II can read and write diskettes recorded in 
an IBM-3740-5imilar format (single-sided, single-density). 
The EXQRdisk III can read and write all diskettes that the 
c-voo -I ,• - 1. TT - ^»> ^'sndle. in addition.- diskettes forfliatted in 
the Motorola sing le— density / double— sided format can also be 
read and written. The double-sided diskettes cannot be used 
in the EXQRdisk II. 

The above minimum configuration will allow the user to 
run any of the MDQS commands that reside on the MDOS system 
diskette at the time of purchase. Other additional hardware 
may be required to run the MDOS-Supported software products. 
Such information is described in Appendix H. 

1.2 Additional Supported Hardware 



MDOS also supports a line printer and the reader/punch 
(record) devices of the system console. The line printer 
interfaces to the EXORciser through the printer interface 
module (MEX68PI) which consists of two PIA's plus the 
necessary buffering devices and address decoding. If the 
printer interface from an EDOS system is used instead, it 
must be modified for use with MDOS. The modifications 
consist of adding the following lines to the printer 
interface PIA: 

1. Print select (high=selectBd ) to PBO (pin IB of PIA) 

2. Paper out (low=paper available) to PBl (pin 11 of 
PIA) 

The system console's automatic reader/punch (record) 
devices must be similar to a Teletypewriter's paper taps 
reader and punch. For a complete description of the system 
console requirements consult the "M6800 EXORciser User's 
Guide". 
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MTsnDUC^'ON i- 2 "" SoftujaTS Suppof'fe Rgquired 

1. 3 Software Support Required 

No additional softuars is required to run the operating 
system as it comes shipped on the system diskette. 

1.4 Program Compatibility 

All of the MDOS commands and system files that are 
shipped on the system diskette must be used with that 
particular version of MDOS. MDOS commands and system files 
from other versions should never be intermixed. 
MOOS-Sup ported software products (see Appendix H) with 
version numbers 3.00 or greater must be used mith MDOS 3. OO. 

.-.^ . ..- 1 ^ J. _-^ .4.« /.«-^t»«»^ + i !i i.H -hh n-rior versions of MDGS. 

In addition, prior versions of the M6800 Linking Loader 
(RLDAD, through version 2.03) will not operate with MDOS 
3.00. Prior versions of other MDOS-Supported software 
products mill tuork with MDOS 3.00. 

Most user-written assembly language programs that \uere 
developed independently of MDOS can be executed on an MDOS 
system luithout reassembly; however, such programs uiill have 
to be converted into the memory-image file format before they 
can be loaded from diskette into memory (see section 2.8.5). 
Programs need only be changed when transferred to MDOS if: 

1. They make assumptions about the 

initialization of the stack pointer after 
they ars loaded into memory, 

2. They are origined to load (initialize memory 
while loading) below hexadecimal location 
$20, 

3. They make assumptions about the physical 
structure of diskette tables or files. 

4. They utilize the diskette for input/output, 

5. They make assumptions about the contents of 
the SWI and IRQ interrupt vectors. 

If a user has prior EXORciser support software products 
yhich he has purchased from Motorola (e. g. , editors, 
assemblers, or compilers), that software must be upgraded to 
be compatible with MDOS. 

If a user has software that he has developed using 
previous versions of MDOS, then Appendix J should be 
consulted for a list of differences between MDOS 3.00 and 
prior versions that may affect programs running -with MDOS 
3. 00. 
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INTRODUCTION i. 5 — Hardware Installation 

1.5 Hardware Installation 



The floppy disk controller module and drive unit should 
be inspected upon receipt for broken* damaged, or missing 
parts as well as for damage to the printed circuit board. 
The packing materials should be saved in case reshipping is 
necessary. 

1. 5. 1 Four— drive system installation 



The following procedure must be performed to install the 
four diskette drive version of the EXDRdisk III. This 
section is not applicable to EXORdisk II systems or to 
dual-drive EXORdisk III systems. This procedure must be 
performed before the floppy disk controller module is 
installed (next section). It should be noted that in the 
four-drive configuration, all diskette controller originated 
lines must be terminated in the last drive of the daisy 
chain. When facing the front of the disk drive units, drive 
zero is on the left and drive one is on the right of one 
unit, while drive two is on the left and drive three is on 
the right of the other unit. Before the following 
modifications are made, both dual-drive units are identical. 

1. The housings from both dual-drive units must be 
removed. 

2. In the dual-drive unit that is to contain drives zero 
and one, the Terminator Network (Motorola P/N 
51NW9626A01) should be removed from the socket XA22 
on printed circuit board (pcb) for drive zero. The 
drive one pcb socket XA22 should not have the 
Terminator Network installed. 

3. JPR 11 should be installed in the jumper area of the 
pcb for drive zero. 

4. JPR 9 should be installed in the jumper area of the 
pcb for drive one. 

5. The housing should be replaced on this dual-drive 
unit and the drives marked as zero and one. 

fe On the other dual-drive unit the Terminator Network 
should be installed in socket XA22 of the pcb for 
drive three. There should be no Terminator Network 
installed on socket XA22 of the pcb for drive two. 

7. JPR 11 in the. jumper area of the pcb for drive two 
should be removed (if installed). JPR S should be 
installed. 
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1.5 — Hardu/are Installation 



g jpR 9 in the jumper are of the pcb for drive three 
should be removed (if installed). JPR 10 should be 
instal led. 

9. The 50-pin ribbon cable that connects to PI of the 
Controller Interconnect Board must be disconnected 
and insulated against 
material. 






10. The housing on this dual-drive unit should be 
replaced and the drives marked as two and three. 

11. The 50-pin ribbon cable (Motorola P/N 30BWiS24X01) 
should be installed betujeen drives zero/one and 
tujo/thrse. 

1.5.2 Floppy disk controller installation 



To install the floppy disk controller module into the 
EXORciser, the following steps should be followed: 

1. The PWR .keyswitch on the EXORciser should be 
turned OFF. CAUTION: Inserting the floppy 
di^k controller module while power is applied 
to the EXORciser system may result in damage 
to components of the module. 

2. Any other card in the EXORciser that responds 
to addresses between hexadecimal $£S00 
through $EC07, inclusivei must be removed 
from the system or configured for a different 
address range. 

3. The floppy disk controller module can then be 
inserted into any available card slot. It is 
desirable to keep all of the cards in the 
EXORciser close together; it is specifically 
recommended that dynamic memory boards be 
kept as close to the MPU board as possible. 
When properly installedi the component sides 
of all cards should be facing the left-hand 
side of the EXORciser chassis (as viewed from 
the front). The EXORciser motherboard 
connectors are offset and keyed to prevent 
backward installation of cards. 

4. The interconnect cable should then be 
attached to both the drive unit and the 
diskette controller module. CAUTION: The 
pin index mark on the connector must match up 
with the index mark on the cable. Damage to y 
the module will result if the cable is 

installed the wrong way. 
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1.5 — Hardware Installation 



5. Power can nou) be applied to both the drive 
unit and to the EXORciser — the hardware is 

installed. The operator should get into the 

habit of turning on the power in the 

following sequence: system console/ 

EXORciser, EXORdisk, and line printer. The 

power off sequence should be the reverse: 

I J __j_j.~--. cvr^OAisU. CYnPf -i cn-r . anrf SLt^t^fll 

4Xi)e jiiiiiuci / s;.^i-*iiM *Sn# »-.#-.»».■.■--—'..- — ^ -s 

console. No diskettes should be in a drive 
while the drive's or the EXORciser's power is 
being turned on or off. 

1.6 Software Installation 



There is no software installation that need be 
performed. All MDOS software is included on the diskette 
that is shipped with each EXORdisk. This diskette contains 
the operating system and a set of commands that comprise 
MDOS. It may or may not contain any of the MDOS-supported 
software products such as editors or assemblers. These 
products are dependent on the mode of system purchase. 
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2. GENERAL SYSTEM OPERATION 

Tu i ^ ,-Kja«4-«^ wf* (^ vr -i /^ Q c t-ha neo'r iiiT th the hA^lC COnC&OtS 

that are necessary for the simplified and typical operation 
of MDOS. It contains descriptions and examples of the 
initialization procedures and of the basic forms of the most 
frequently used commands. These examples clearly illustrate 
how MDOS is used to edit a programi to assemble iti to 
convert it into a loadable module, to load it and execute it, 
as luell as some other useful operations. The commands are 
presented in a sequence that is commonly followed in a 
software development environment. 

2.1 System Initialization 

To initialize the operating system, power must first be 
applied to the EXORciser and to the diskette drive unit. No 
diskette should be in the drive while power is being turned 
on or off on' either the drive or the EXORciser. Once the 
power is oni the following steps must be followed: 

1. EXbug must be initialized and configured for 
the proper speed of the system console. If 
power has just been turned on for the first 
time, EXbug initialization is automatically 
performed by the powei — up interrupt service 
routine in EXbug. If power is already on and 
MDOS is to be re-initial i zed» then either the 
ABORT or RESTART pushbuttons on the 
EXORciser 's front panel must be depressed to 
initialize EXbug. The prompt "EXBUG V. R" 
will be displayed by EXbug indicating it is 
waiting for operator input. "V" indicates 
the version and "R" the revision number of 
the EXbug monitor in the system. 

2. An MDOS diskette (one shipped from Motorola 
or one that has been properly prepared by the 
user (see section 2.8.10)) must be placed in 
drive zero. The door on the drive unit must 
then be closed in order for the diskette to 
begin rotating. For the side-by-side drives, 
drive zero is on the left side, as seen from 
the front. For the EDOS-c on verted systems 
using the vertically stacked drives, drive 
zero is the top one. 

The diskette must be oriented properly before 
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being inserted into the drive. When the 
diskette is inserted properly* the label is 
facing up* and the edge of the diskette with 
the long narrow slot in the protective 
covering is inserted first. The labelled 
edge will be the last edge to be covered up 
as Tsne aisnet^e i3 *ii = = i vcv» .knvw w^ -■ •■!?-. 

3. Operators with EXbog 2 in their systems will 
skip this step. The EXbug 1 command "MAID" 
must be entered. An asterisk (■») prompt will 
be displayed once MAID has been activated. 

4. The MAID command "EBOOi S" must be entered if 
the debug monitor is EXbug 1. .^or EXbug 2 
monitors, the EXbug command "MDOS" must be 
entered. Either command will give control to 
the diskette controller at the specified 
address. The controller will initialize the 
drive electronics and then proceed to read 
the Bootblock into memory. Once the 
Bootblock has been loadedi control is 
transferred to it. The Bootblock will then 
attempt to load into memory the remainder of 
the resident operating system. 

2. 2 Sign-on Message 

If no errors occur during the initialization process. 
MDQS will display the message: 

MDOS VV. RR (M6800) 

MD0S09 VV. RR (M6809) 

meaning that MDOS has been successfully loaded from disk and 
initialized. The "VV" and "RR" indicate the version and 
revision numbers of the operating system. respectively. In 
addition. an equal . sign <=) is displayed as a prompt 
indicating that MDOS is ready to accept commands from the 
operator. The equal sign prompt is subsequently displayed 
each time the MDOS command interpreter gets control. The 
sign-on message showing the version and revision numbers is 
only displayed when MDOS is reloaded from the diskette. 

2.3 Initialization Error Messages 



If for some reason the drive electronics ars not 
pyoperiy initialized, or if the diskette in drive zero cannot 
be read properly to load the Bootblock or the resident 
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operating system^ then a two-character error message will be 
displayed and control returned to the. EXbug monitor.. 

The follouing errors can be produced during 
initialization. All two-character messages begin with the 
letter "E". 



El A cyclical redundancy check (CRC) 

error was detected while reading the 
resident operating system into 
flvem^ry . 

E2 The diskette has the write protection 

tab punched out. During the 
initialization process, certain 
information is written onto the 
diskette. 

The diskette is not damaged and can 

still be used for a system diskette; 

however; the write protection tab 

must first be covered with a piece of 

opaque tape to allow writing on the 
d iskette. 

E3 The drive is not ready. The door is 

open or the diskette is not yet 
turning at the proper speed. If the 
diskette has been inserted into the 
drive with the wrong orientation, the 
"not ready" error will be also 
generated. If a double-sided 
diskette is used in the EXORdisk II 
drives* this error will also occur. 

Closing the door» waiting a little 
bit longer before entering the 
"EBOO; G" or "MDOS" command/ or 
turning the diskette around so it is 
properly oriented should eliminate 
this error. 

E4 A deleted data mark was detected 

while reading the resident operating 
system into memory. 

E5 A timeout interrupt occurred. This 

indicates . that a diskette controller 
function was not completed within the 
allotted time. This error can also 
occur if the ABORT pushbutton is 
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.^-^ 
depressed uhile a diskette transfer ; 

is in progress. 

E6 The diskette controller has been 

presented with a cylindei — sector 
address that is invalid. 

This error indicates sorae type of a 
hardware problem. For example^ the 
error can be caused by missing or 
overlapping msmoryj bad memoryj or 
pending IRQs that cannot be serviced. 

E7 A seek error occurred while trying to 

T9sd the resident operating system 

Like E6 errors* this one indicates 
some type of a hardware problem. 

EB A data mark error was detected while 

trying to read the resident operating 
system into memory. 

E9 A CRC error was found while reading 

the address mark that identifies ^ 

sector locations on the diskette. _y 

The diskette controller errors El* E4. EBi and E9 

indicate that the diskette cannot be used to load the 

operating system; however^ a new operating system can be 

generated on that diskette^ making it useful again. Chapter 

10* DOSGEN command, and chapter 15i FORMAT command* describe 
ways in u/hich damaged diskettes can be regenerated. 

Depending on the extent of the errors* the diskette may be 

used in drive one to recover any files that may be on it 
(section 2. S. 9). 

The diskette controller error E5 can occur for a variety 
of reasons. The most common reason, and the most fatal* is 
the destruction of the addressing information on the 
diskette. If the addressing information has been destroyed 
(verified by using DUMP command to examine areas of 
diskette), the FORMAT command may be used to rewrite the 
addressing; however, information on the damaged diskette 
cannot be recovered. Occasionally, after a system has just 
been unpacked* the read/write head may have been positioned 
past its normal restore point on cylinder zero. In this 
case, trying the event which caused the error three or more 
times may position the head to the proper place. If this 
fails, the head will have to be manually repositioned past 
cylinder zero; however, this problem rarely occurs. The E5 
errors can also occur if a user— written program accesses 
drives 1—3 without using one of the system functions and 
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without first restoring the read/u/rite head on that drive. 

Even after the resident operating system has been 
successfully read into memory; certain errors can occur in 
the subsequent initialization procedure. During 
initialization the resident operating system cannot access 
the error message processor since it has not been 
initialized. Messages sifliiiar in TOrinav t»o «>iiu3e generai/Su 
by the diskette controller are displayed to indicate such 
errors. They differ from the diskette controller errors in 
that the second character of the two-character message is a 
non-numeric character. The following errors can occur during 
initialization* but only after the resident operating system 
has been read into memory. 

Message Probable cause 



E? This error indicates that the 
Retrieval Information Block (RIB) of 
the resident operating system file 
MDOS. SY is in error. The operating 
system cannot be loaded. 

The diskette probably is not an MDOS 
system diskette* or the system files 
have been moved from their original 
places. The RB'AIR command (Chapter 
22) can be used to identify which 
files are missing or if their places 
have been changed. 

EM This error indicates that there was 
insufficient memory to accommodate 
the resident portion of the operating 
system. 

The memory requirements described in 
section 1. 1 should be reviewed. If 
the minimum requirements are 
satisfied* then the existing memory 
should be carefully examined for bad 
locations. 

EI The version and revision ef MDOS 
already loaded into memory are not 
the same as those on diskette. This 
error usually occurs as the result of 
switching diskettes in drive zero 
without following the initialization 
procedure outlined in section 2. 1. 
The error can also occur if the ID 
sector has been damaged. 
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-"> 

The error can be avoided if the -^ 

initialization procedure is followed 
correctly every time a new system 
diskette is inserted into drive zero. 

The addresses of the Retrieval 
Information Blocks of the MDOS 
overlays ars not the same as those at 
the time of the last initialization. 
This error may occur for the same 
reasons as the "EI" error. 

An input/output system function 
returned an error during the 

- L! ^ _• J..' c^'n^.n.- ry-i •♦• h -1 c a.nir i; 

mi "ciai i xa* AU!i- i_i 1 "■ a w' ».. - - — ■ - 
indicate a possible memory problem or 
the opening of the door to drive zero 
while the initialization is taking 

place. 

EV One of the system files is missing or 
cannot be loaded into memory. If a 
system file is missing.- the diskette 
has been improperly generated or the 
file was intentionally deleted. If a 
file cannot be loaded/ then. the 
diskette should be regenerated. The -" 

diskette may be used in drive one to 
save any files that may be on it 
(section 2.8.9). This error may also 
occur if the door to drive zero is 
opened while initialization is in 
progress. 

2. 4 Operator Command Format 

After the sign-on message is displayed, MDOS is ready to 
accept commands from the operator. The equal sign prompt <-) 
indicates that the command interpreter is awaiting input via 
the console. Generally, the equal sign prompt will be 
redisplayed after each command has finished its function. 
The operator-entered command line must always indicate which 
command is to be executed. In addition, the file names that 
may be required by the command must be speci^^ied. Some 
commands also allow various options that can alter the way in 
which their functions are performed. These options are also 
entered on the command line. Each command line must be 
terminated with a carriage return. The command line has the 
fallowing format: 

<name 1> <naffle 2>, <name 3>, : . . . , <name n>;<options> . _^ 

where each <name i> (i=i to n) has the form of a complete 
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MDOS file name (see section 2.7. 1). The name of the command 
to be executed is alujays <name 1>. The remaining names and 
the options may not be required, depending on the individual 
command. The follouiing lines: 

DIR EDIT. CM: 1;E 

FREE 

MERGE FILEl: 1, FILE2: 0, FILE3: 1. FILEl: 1 

are valid examples of MDOS command lines. Section 2. 8 
describes in a simplified form the basic format (i.e.. the 
command's name. what file names must be specified, and ujhat 
options ars available) of the most frequently used commands. 
PART II gives a complete and detailed description of all MDOS 
commands. In addition. Appendix H contains a summary of the 
command line formats of all MDOS-Sup ported software products. 

Most frequently a "space" is used to separate <name 1>, 
the command name, from the other names which are typically 
separated by "commas". The "semicolon" always separates the 
options from the rest of the command line. The "space" and 
"comma" are the recommended separators since they make the 
command line the most readablej however, any character that 
will not be mistaken for an MDOS file name character, a 
suffix delimiter, a logical unit number delimiter, or a 
' device name delimiter (see section 2.7.1) can be used as a 
separator. The use of special characters, although 
permitted, is not recommended because the command line 
becomes very unreadable. 

2. 5 System Console 

The system console is used as the communications device 
between the operator and the operating system. MDOS messages 
are displayed on the console printer or display mechanism. 
MDOS commands, as well as operator inputs prompted by the 
commands, are entered via the keyboard. All command line 
input and most input to the various commands requires upper 
case, alphabetic characters. Numeric and special characters, 
of course, are case independent. To allow corrections to be 
made to any typed line before the terminating carriage return 
is entered, several special keys on the keyboard can be used. 
In addition, two other special keys serve to prematurely 
abort a command in* progress or to "freeze" the display of 
messages on the console. 

2. 5. 1 Carriage return key 

The CARRIAGE RETURN key is used to terminate any 
operator response to an MDOS input prompt. This is true for 
the command line as well as all other input that may be 
required from the operator by the various commands. The 
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CARRIAGE RETURN will automatically 
return and line feed functions. 



perform both carriage 



J 



2. 5. 2 Break key 



ns 



sDc^j^ kail is used as a csntrolled— abort function 
key. Most MDOS commands that take a long time to complete 
their function periodically check to see if the BREAK key has 
been depressed. If it has, the command will come to a 
premature, but controlled, termination point. 



The BREAK key should be used, whenever possib 
alternative to using the EXORciser's ABORT or 
pushbuttons. The controlled abort that is achieved 
BREAK key ensures that all system tables av^ intact 
termination is delayed until all critical diskette 
have been completed, no file space is lost nor is an 
table destroyed. Such precautions cannot be guar 
the ABORT or RESTART pushbuttons av9 used, since the 
has no may of knowing whether or not diskette data 
are in progress. 

2. 5. 3 Control-W 



le. as an 

RESTART 

with the 

Since 

accesses 

y system 

anteed if 

operator 

ransf srs 



Contro 
depressed 
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It the display of 
inter. All commands 
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MDOS commands that 
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e CTL-W key has been 
ommand will suspend 
console keyboard is 
-W). This feature 
splay for viewing on 
f output is being 
n be used to suspend 



J 



I. 5. 4 Control-X 



Control-X is actually a combination of two keys being 
depressed simultaneously; the CONTROL or CTL key and the X 
key. This combination is used to cancel the input line that 
was just entered by the operator (before a carriage return is 
depressed). All system input from the console supports 
CTL-X. Any characters entered on the current input line thus 
far will be deleted and input can be resumed from the 
beginning of the line. A carriage return and line feed will 
be sent to the console, so that the operator has a positive 
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feedback that the line uias cancelled. 
2. 5. 5 DEL or RUBOUT 



The DEL or RUBOUT key serves as a backspace key during 
console input. If the operator detects an error in the 
current input line (before a carriage return is depressed), 
the DEL key will cause the preceding character to be removed 
from the input line. The character that is removed mill be 
echoed back to the console so that the operator has a 



positive 
line. 



feedback that a character was backed out of the 



2. 5. 6 Control-D 



Control 
depressed s 
key. This c 
current inp 
depressed ) . 
backed out 
The CTL-D ke 
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1 ine will be 
line. Oper 
Any reroainin 
terminating 
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combination of two keys being 
the CONTROL or CTL key and the D 

the op.erator to re-display the 
a terminating carriage return is 
e has had several characters 
e>, the line is very unreadable. 

be used to show a "clean" copy 
inspection. The newly displayed 
e following the current input 
t terminated with the CTL-D key. 
1 be supplied^ as well as the 



2. 6 Common Error Messages 
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ges ars common to the MDOS commands. In 
of the most common errors, their 
luded here. These common error messages 
to the operator since they are prefaced 
terisks (**) and a two-digit reference 
d may, in addition, have a set of 
ages that will not be displayed by other 
ific error messages will not have the 
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y of the standard error messages can be 
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The first name entered on the command line was 
not the name- of a file in the diskette's 
directory. Most often this error occurs as the 
result of a mistyped command name. 
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»* 01 COMMAND SYNTAX ERROR 



The syntax of the command line parameters could 
not be interpreted. Most often this error refers 
to undefined characters appearing in the options 
field. 



»* 02 NAME REQUIRED 



The file name required by the command as 
parameter was omitted from the command line. 



** 03 <name> DOES NOT EXIST 



diskette 's 
prior to 
displayed 



lori file n^ffle uias ngt found in the 

directory. The file name must exist 

using the command. The <name> is 

to shouj which name of the multiple 



names specified as parameters caused the error. 



»•* 04 FILE NAME NOT FOUND 



The file name 
parameter 
directory, 
using the 
sines only 
command. 



entered on the command line as a 
does not exist in the diskette's 
The file name must exist prior to 
command. No file name is displayedi 
one parameter is required by the 



** 05 <name> DUPLICATE 'FILE NAME 



name already exists in the 
The file name must not 

the command. The <name> is 
displayed to shoui which name of the multiple 
names specified as parameters caused the error. 



The displayed file 
diskette's directory. 
exist prior to using 



*■» 06 DUPLICATE FILE NAME 



The file 
parameter 
directory 
using the 

since only 
c Q mma n d . 



name entered on the command line as a 

already exists in the diskette's 

The file name must not exist prior to 

command. No file name is displayed. 



one parameter is required by the 



»-» 07 OPTION CONFLICT 



The specified options were not valid for the type 
of function that was to be performed by the 
command. Several of the options are mutually 
exclusive and cannot be specified at the same 
time. 
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** 11 DEVICE NOT READY 

Most frequently this indicates that a command is 
trying to output to the printer while the printer 
is not ready. 

*» 12 INVALID TYPE OF OBJECT FILE 

Most frequently this indicates that an attempt 
tuas made to load a program into memory whose file 
does not have the "loadable" memory-image format* 
e. g. I a source file. 

** 13 INVALID LOAD ADDRESS 

An attempt mas made to load a program into memory 
that: 1) loads outside of the range of 
contiguous memory established at initialization; 
2) loads over the resident operating system; 3) 
loads below hexadecimal location $20; or 4> loads 
beyond hexadecimal location *FFFF. 

»* 25 INVALID FILE NAME 

A file name luas specified that contained a family 
indicator (*)- that began with a device name 
indicator (#>i or that did not begin luith an 
alphabetic character. 

** 41 INSUFFICIENT DISK SPACE 

A command is trying to create a file or to write 
into a file. Upon trying to allocate more file 
space. insufficient room remains on the diskette 
to accommodate the space requirements. 

♦♦PROM I/O ERROR — STATUS=nn AT h DRIVE i-PSN j 

An unrecoverable error occurred while trying to 
access the diskette. The error status "nn" is a 
value returned by the diskette controller. The 
errors are of the same type that cause the 
initialization process to give control to EXbug; 
however* instead of beginning with the letter 
"E"i the status (nn) begins with the digit "3". 
The second digit of the status corresponds 
directly to the diskette controller error number 
discussed in section 2.3. The "E" has been 
replaced by the "3". Thus/ status 
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31 is the same as El 

32 is the same as E2 



39 is the same as E9. 

A memory address (only meaningful for system 
diagnostics) is substituted for the letter "h"; 
the drive number is substituted for the letter 
"i"; and the physical sector number <PSN) at 
which the error occurred is substituted for the 
letter "j". 



3 7 niakorrs File Cancsots 



In MDOS, a diskette file is a set of related information 
that is recorded more or less contiguously on the diskette. 
The information can be actual machine instructions that 
comprise a command or user program. The information can also 
be textual datai object program dataj or any of the forms 
described in Chapter 24. The following section describes how 
files are named, created^ deleted, and protected, 

2.7. 1 File name specifications 



An MDQS file name specification consists of three parts: 
a "file name", a "suffix"/ and a "logical unit number". File 
names can be from one to eight alphanumeric characters in 
length. the first of <i*hich must be alphabetic. The 
alphabetic characters must be upper case letters. Valid file 
names could look like the following: 

DIR 

ASM3a70 

BACKUP 

SO 

BLOKEDIT 

Z 



In most cases, all that need be specified when a 



name specification 



ca. 



for 



IS 



the file name. 



file 



suffix and logical unit number are usually given 
default values by the various commands. 



appropriate 



The suffix can be either one or two characters in 
length. Like file names, suffixes must begin with an upper 
case alphabetic .character. The rest of the suffix must be 
alphanumeric. A suffix is used to explicitly refer to a 
particular entry in the directory. That is. there may be 



several entries with 
suffixes. In such 



the same file name 
cases, a file name 



but with different 
reference alone would 
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be ambiguous. Thus, the suffix is used to differentiate 
between" entries with the same file name. Usually, suffixes 
designate a particular format of the file. Thus, a source 
file could have the suffix "SA". Its assembled object 
version could have the same file name but with the suffix 
"LX". and its executable version could have the same file 
name but with the suffix "LD". MDOS commands usually supply 
an appropriate default suffix uihen dealing uiith specific 
files. 

If both file name and suffix sre specified, they must be 
separated by a period C. ). The follouiing are examples of 
valid file name specifications using both file name and 
suffix: 

Z. SA 

PROCl. CF 
DOCUMENT. Y 

Since each diskette is a complete file system in itself- 
ujith complete directory and system files, it is possible to 
have directory entries with the same file names and suffixes 
on separate diskettes. Thus, the logical unit number is 
required to uniquely specify a directory entry on a given 
drive. Logical unit numbers consist of a single decimal 
digit (0, 1, 2, or 35. In most case,5, MDOS commands sup ply, a 
default value for the logical unit number. If a particular 
drive must be identified, it must be entered by the operator 
as a part of tiie file name specification. Logical unit 
numbers follow either the file name or the suffix depending 
on whether one or both are specified. The logical unit 
number must be separated from the file name or from the 
suffix by a colon (: ). The following are examples of valid 
file name specifications using logical unit numbers. 

BLOKEDIT. CM: 
TEST. X: 1 
DIR: 1 
Z456. D3: 3 
ASM: 2 

2. 7. 1. 1 Family names 

Some commands allow the operator to specify a family of 
file names. Family indicators can occur in either the file 
name or the suffix. An asterisk (») is used as a family 
indicator. The family indicator represents all or part of a 
file name or suffix. For example. 

FILE. * 

would be a file name specification that includes all 
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directory entries uiith the file name "FILE " but with any 
suffix on the default drive. Similarly* 

PROQ*. SA 

is a file name specification that includes all directory 
entries with "PROG" as the first four characters of their 
file names, regardless of u»hat the remaining characters avB, 
and with suffix "SA" on the default drive. The asterisk 
cannot have characters following it. ThuS; the following 
file name specifications are invalid: 

*FROG. SA 
PROGRAM. »S 

Not all commands allow file name specifications to 

contain the family indicator. The individual command 

descriptions should be consulted to see where family 
indicators avs acceptable. 

2.7. 1.2 Device specifications 



Some commands allow the operator to enter a device 
specification in the command line instead of a file name 
specification. Device specifications consist of two parts: 
a "device- name" and an optional "logical unit number". 
Device names ars two characters long, both of which must be 
alphabetic. A pound sign (#) is used as a leading character 
to indicate that the subsequent two-character sequence is a 
device name. For example, 

#LP 

are valid device names used for the line printer and the 
console, respectively. A device specification may be entered 
with a logical unit number. Logical unit numbers must follow 
the device name and must be separated from it by a colon <:). 
The individual command descriptions should be consulted to 
see where device specifications avs allowed. 

2.7.2 File creation 



MDOS files ars never explicitly created by the operator. 
All commands that write to output files will create them 
automatically if they do not exist. Files will be created 
according to the file name specification given on the command 
line. That is, if explicit suffixes and logical unit numbers 
ars specified, the file will be created on the indicated .^^ 

drive. Otherwise, the appropriate default values supplied by ^j 
the command will be used to create the file. Existing files "" 
are unaffected by the creation of a new file. 
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2. 7. 3 File deletion 



Unlike file creation. file deletion is controlled 
explicitly by the operator via the DEL command which is 
described later. No other command program will delete 
existing files on the diskette. Exceptions to this sve 

j,u_j- 4.___4..: - - 1 1 .. i--^mjs*-s a" i Ti+-a'nmofl t ate UJDT k file 

c omman s s tnais au vsma i..it.aj..>.^ *.!=»»£ a.. ...... ==:= =■_- 

to perform the command's function. These intermediate files 
are deleted by the command as an automatic clean-up process. 

2.7.4 File protection 



All MDOS files can be configured with delete protection, 
with write protection. or with no protection. Delete 
protection will prevent the operator from inadver-cen-ciy 
deleting the file (the protection can be changed by the 
operator so that the file can be deleted). Write protection 
will prevent any command from writing to that file as well as 
preventing deletion of the file. Normally, files are 
unprotected, allowing both writing to or deletion of the 
file. The NAME command, described later, can be used to set 
or to change a file's protection. 

2.8 Typical Command Usage Examples 

The following sections give simple. but meaningful, 
descriptions and examples of the most frequently used MDOS 
commands in a typical software development environment. No 
attempt is made in these sections to cover all capabilities 
and options of the described commands. The detailed command 
descriptions in PART II serve that purpose. After reading 
this section, the operator should be able to go "on-line" 
with MDOS and be able to display the directory of a diskette, 
create a source proaram file, assemble it. and load it into 
memory for testing. The commands to delete a file, to change 
its name or protection, to copy it between diskettes or to 
tape are also described. New MDOS diskette generation is 
discussed in the last part of this section. 

It is assumed in the subsequent discussion that the 
system has been properly installed and initialized. Thus, a 
system diskette with the MDOS commands resides in drive zero. 
Command program files have a suffix of "CM" which is supplied 
as a default to the first file name that is entered on the 
command line. The default logical unit number that is 
supplied is ":0". In the command examples that follow. it 
will be seen that both suffix and logical unit number are not 
specified for the command name. 

The following notation will be used in the description 
of the command line formats as well as throughout the 



Page 02-15 



g£f>j£l^^i_ SYSTEM OPERATION 2.8 — Typical Command Usage Examples 

remainder of the manual: 

Notation Meaning 



$nnnn Hexadecimal number "nnnn". 

<> Syntactic elements are printed in 

lower case and avs contained in 
angle brackets* e. g. s <Qptions>j 
<name>. 

12 Optional elements ars contained 

in square brackets. If one of a 
series of elements may be 
selected* the available list of 
elements will be separated by the 
word "or". e. g. . C<tagl> or 
<tag2>3. 

<> A required element that must be 

selected from the set of elements 
will be contained in curly 
brackets. The elements will be 
separated by the word "or". 

All elements that appear outside of angle brackets (<>) 
must be entered as is. Such elements avs printed in capital 
letters (if words) or printed as the actual characters (if 
special characters). For example* the syntactical element 
C; <options>3 requires the semicolon (j ) to be typed whenever 
the <options> field is used. 

2. a. 1 DIR — Directory display 



The DIR command is used to display the contents of a 
diskette's directory. Either the entire directory or 
selective parts of it can be displayed. The format of the 
command line for the DIR command is: 

DIR C<name>3 C;<options>3 

The file name specification <name> indicates what to 
display. The <options> specification indicates how to 
display it. If DIR is entered by itself on the command line* 
it will display on the system console the file names of all 
user-generated files on drive zero. If no user-generated 
files exist on drive zero* a message will be displayed 
indicating that no directory .entries were found. This is 
normally the case when DIR is used without any options on the 
system diskettes that are shipped with the new system. To 
display the system and the user— generated files. the "S" 
option can be placed into the options field: 
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DIR ;S 

If drive one's directory is to be displayed, then a ":1" 
must be typed in place of the file name specification: 

DIR : IjS 

To dirsct the Qutpuw qt the u^H CGiiiniaTiu **o *^us prinvsri 
only one other option letter need be specified — "L". Thus. 

DIR : 1;LS 

will produce a listing of drive one's complete directory on 
the printer. The "S" and "L" can be in any order, as long as 
they follow the semicolon. 

The DIR command can also be used to see if a specific 
file name exists on a given drive. This is accomplished by 
entering a complete file .name specification (i.e.. name, 
suffix, and logical unit number). Thus. 

DIR EDIT. CM: 1 

will perform a directory search for the indicated file name 
specification on drive one. If the directory entry exists. 
its file name and suffix mill be displayed. Otherwise. a 
message indicating that no entries were found will be 
displayed. Directory searches for specific file names do not 
require the "S" option to distinguish between system files 
and user files. Chapter 9 contains a complete description of 
the DIR command's use. 

2.8.2 EDIT — Program editing 



The EDIT command is used to create and/or to change 
user— written source program and data files on diskette. The 
EDIT command, although an MDOS-Supported product which may be 
purchased separately, is mentioned here since it is such an 
integral part of the software development environment. The 
EDIT command, if not included on the MDOS system diskette, 
must be copied from the diskette on which it was shipped (see 
section 2.8.9). Once the EDIT command resides on the system 
diskette, it is invoked with the following MDOS command line: 

EDIT <name> 

If the EDIT command is not copied to the system diskette, it 
can be invoked from the diskette in drive one with the 
following command line: 

EDIT: 1 <naffle> 

The only parameter supplied on the command line is the 
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name of the file that is to be edited. If the file does not 
exist, the EDIT command will create the file; if the fi^e 
already exists, then it will be used. The suffix "SA'S uihich 
is typically used for ASCII source files, is automatically 
supplied as a default if no suffix is entered on the command 
line. Thus, the user need only specify the name of the file 
to be edited. Upon complaticn of an edit, ths file naass will 
be unchanged. That is, a user need not be concerned about 
renaming his files betu/een edits. A complete description of 
the EDIT command's format and usage is found m the manual 
accompanying the EDIT command diskette, "n6800 Co-Resident 
Editor Reference Manual". 

2.8.3 ASM or RASM — Program assembling 






The ASM and RASM commands for MDOS and RASM09 command 
for MDOSO? (hereafter called the assemblers) are use<i *o 
assemble the source program files created uiith the wD. . 
command. The assemblers translate these source programs into 
object programs. The assemblers, although both 
MDOS-Sup parted software products which may be purchased 
separately, ars mentioned here since they are such an 
integral part of the software development environment. If 
not included on the MDOS system diskette, the assemblers must 
be copied from the diskette on which they were shipped (see 
section 2. S. 9). Once the assemblers reside on the system 
diskette, they are invoked with the following MDOS command 
line: 

<ASM or RASM or RASM09> <name> Cj<options>l 

If the assemblers are not copied to the system diskette in 
drive zero, they can be invoked from the diskette m dvi'^e 
one by using the following command line: 

<ASM: 1 or RASM: 1 or RASM09: 1> <name> C; <option5>3 

The only req.uired parameter is the name of the file that 
is to be assembled. Normally, this would be the name of the 
file specified in the previous description of the EDIT 
command. The assemblers will automatically supply the 
default suffix for both the source file that is read (SA) and 
for the object file that is created (LX, assuming that the 
gpT RFL or- OPT ABS assembler directive was not used). Such 
an object file will be in the standard. EXbug-loadab le 
format Such files cannot, however, be loaded by MDOS (see 
section 2. S. 5). The object file will have the same file name 
as <name>i but a different suffix will be assigned to it to 
differentiate it from the source file. 

Normally, a listing of the assembled program is desired. 
The assemblers will not produce a source listing unless the 
option to do so is specified in the <options> field. Thus, 
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the command line to assemble a source program file named 
TESTPROG with source listing output mould appear as: 

■CASH or RASM or RASM09> TESTPROG; L 



As with the 
printed output 
available, or if 
be produced on 
option: 



DIR command, the "L" option directs the 
to the printer. If a printer is not 

the program is short, the source listing can 
the system console by using the follQwing 



•CASM or RASM or RASM09> TESTPROG; L=#CN 



If errors are detected during 
uiill be included on the source lis 
is being produced, errors will aut 
the console. Typically, the s 
involves several iterations of 
processes before an erroi — free ob 
assemblers, however, require that 
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During the iterative process of editing/assembling to 
obtain an error-free program, the object file created by the 
assembler can be suppressed by specifying the option "-0" in 
the options field. The command line 

<ASM or RASM RASM09> TESTPROG; L-0 

for example, will assemble the source program as in the above 
examples creating the listing on the line printer; houiever, 
the object file will not be created. Thus, the deletion of 
the object file between repetitive assemblies is not required 
since it is never created. 

The "M6800 Resident Assembler Reference Manual" or the 

"M6SOO/M6B01/M6805/M6B09 Macro Assembler Reference Manual" 

should be consulted for a complete description of the 
assemblers' function, usage, and command format. 

2.8.4 DEL — File deletion 



The DEL command is used to delete file names from the 
directory. The removal of a file's name from the directory 
makes the file unaccessible to any other process. The file 
itself is effectively deleted. Thus, in the subsequent 
descriptions, the phrases "delete a file name" and "delete a 
file" are equivalent. The format of the command line for the 
DEL command is: 
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DEL <naroe> 

which will cause the specified file to be deleted. If the 
object file from the assembly process example above is to be 
deleted. for instance* the following con«nand line would be 
entered: 

DEL TESTPROS. LX 

It should be noted that the suffix is specified. Since 
the DEL command is a general purpose command, like the DIR 
command, no default value for the suffix is supplied. Only 
those commands that can validly make an assumption about the 
type of file they will be dealing with <e. g.. EDIT, ASlii 
RASM5 will supply default suffixes. 

The DEL command will display a message indicating that 
the file name was deleted or that the file name was not 
found. Chapter 8 contains a complete description of the DEL 
command's other capabilities. 

2. a. 5 EXBIN — Creating program load module 



The EXBIN. command is used to convert the object file 
from the assembly process (assumes no OPT REL or OPT ABS in 
source file) into a file whose contents can be loaded into 
memory for execution. MDOS can only load programs into 
memory that ars in memory— image files. Thus, the EXBIN 
command must be invoked after an assembly process to create 
the loadable file. The format of the command line for the 
EXBIN command is: 

EXBIN <name> 

The <name> specified on the command line is the name of 
the EXbug-loadable object file created by the assembler. 
Only the file name need be specified. The default suffix 
"LX" is automatically supplied by the EXBIN command. A file 
in the memory— image format will be created by the EXBIN 
process that has the same file name as <name>, but has the 
suffix "LO" to differentiate its file type. The following 
command line 

EXBIN TESTPROG 

will convert the file TESTPROG. LX: to its memory-image 
equivalent TESTPROG. LO: 0. Thus, the processes of editing, 
assembling, and object file conversion can all be performed 
on a file by only, referring to its file name. The suffix 
will be automatically supplied. Normally, EXBIN will not 
display any messages. The next section will describe how to 
load a program from a file into memory after it has been 
converted into the proper format. Chapter 14 contains the 
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complete description of the EXBIN command. 
2.8.6 LOAD — Program loading/execution 

The LOAD command is used to load programs from a 
memory-image file on the diskette into memory. After the 
program has been loaded, the debug monitor can be given 
control (for testing the program), or the program can be 
given control directly (for execution). The format of the 
command line for program loading is: 

LOAD <name> C; <op tions>: 

The name of the file whose contents are to be loaded is 

given as <name>. The default suffix "LO" is automatically 

....--T^«^ Hii -t-ha I n^n rnmmand_ Thus, in normal softuiare 
development, only a file's original source program name is 

required to take a user through the four processes of 

editing, assembling, object file conversion, and program 
loading. 

The <options> field of the LOAD command line is used to 
specify whether the debug monitor or the loaded program is to 
be given control, and whether or not the program overlays the 
resident operating system. If the file TESTPROG from the 
previous examples was origined to the hexadecimal memory 
address $100, the following command line: 

LOAD TESTPROG; V 

would be used to load the program. The "V" option is used to 
specify that the program to be loaded will overlay the 
resident operating system. If the "V" option were left off 
the command line, an error message would be displayed. The 
absence of the "G" option letter means that the debug monitor 
uill be given control after the program is loaded. So, the 
above example would be used to load TESTPROG into memory for 
testing. 

If, on the other hand, the program TESTPROG has already 
been tested and works, the command line: 

LOAD TESTPROG; VG 

would be used to load and execute the program. No operator 
intervention is required to specify the starting execution 
address. This is only true if the starting execution address 
has been specified on the END statement of the source program 
during the assembly process. 

Typically, most user-written programs that have been 
developed prior to receiving the MDOS system would be loaded 
and tested in this fashion. Programs that are developed with 
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MDOS as a basis (i.e., programs that use the ^^^ijj"* ^^^^^^ 
functions) are loaded u^ithout the "V" option. Chapter 18 
describes the details of the LOAD command and should be 
consulted if more information is required. 

rAUTION- AFTER THE DEBUG MONITOR HAS BEEN ENTERED VIA 
THE lSS COnrANB «Dai .^UST NOT BE INITIALIZED VIA "ESOO; G" 
S "MdSs" until either the ABORT OR RESTART PUSHBUTTON HAS 
BEEN DEPRESSED. 

2. S. 7 NAME — File name changing 

The NAME command allou,s file names and/or ^^H^l^^ *° ^l 
*^n«, their oriainally assigned values. Of t8n,_ _ as a 



M K 4^ n ^ W 



p;;g;;; is developed, its author decides that a fixe name 
'other than the original one .ould be more ^P^^^^Prj^^J.^f ^ 
descriptive. The format of the command line for changing a 

file's name is: 

NAME <name 1>, <name 2> 

This command line requires the operator to «"*f^ *';° 

names. The first •—'<"-£, ^=>' /5!^U'"suff! ^ "5" Ts 
original name of the file. ihe ^^■^^'t^\^l^lll'.r' jH 
supplied automatically if none is given by ^''^^Pftf to be 
second name, <name 2>, indicates the neu, "^'"^J=^^* ^^ ^ ^^ 
assianed to the file noui knouin by <name 1>. Thus, if tne 
Mle from the above examples, TESTPROG, u,ere to be given a 
■^ii: descriptive name, such as BLAKJACK, the following 
command tuould be used: 

NAME TESTPROG, BLAKJAC!^ 

In this case, only the file name of the ^°":" /jj^ 
u,ouid be changed. Other files with the name TESTPROG but 
u,ith suffixes other than -SA" (-ould remain unaffected^ The 
contents of the file that has its name changed are also 
unaffected - only the name in the directory is changed. 

2. S. 8 NAME — File protection changing 



The NAME command is also used to change the protection 
3,,^,:;::,?,rof Tfile. The command line format for changing a 
file's protection is: 

NAME <name>; <optians> 

The <name> entry is required to identify the Jjl^ 'J^°" 
attributes are to be changed. The <options> field contains 
^hlietters I. w; or X to indicate houi the protection 
attributes a;e to be changed. The letters take on the 
following meanings: 



-•'~^ 

J 
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D — Set delete protection 

^ — Setwriteprotection 

X ~ Set no protection (remove existing protection^ 

Thus, if the file TESTPROG (source file) is to be 
protected against deletion, the following command line would 



be used: 



NAHE TESTPROG; D 



If the memory-image file that oias produced from the 
source of TESTPROG were to be write protected and delete 
protected, the following command line would be used: 



NAME TESTPROG. LOj DW 

^. .. j-i +.t.-!= *iia rniiifl later be removed uiith 

ine provBi.t.i.u<i <•>'< *»i>*<' .•-- — 

the command line: 

NAME TESTPROG. LD; X 

Chapter 20 describes in more detail the other features 
of the NAME command. 



2. S. 9 COPY — File copying 



The COPY command is used to make a duplicate copy of a 
file on a single diskette, to move a file between two 
different diskettes, or to move a file between the console 
reader/punch (record) device and a diskette. 

To make a duplicate copy of a file on the same diskette, 
the following command line is used: 

COPY <name 1>, <name 2> 

where <name 1> specifies the current name of an existing 
file, and <name 2> specifies the name of the duplicate copy. 
The default suffix "SA" and the default logical unit number 
zero are supplied for <name 1> if those parts of the file 
name specification are omitted. Normally, the destination 
file. <narae 2>, does not exist. The COPY command, however, 
will alert the operator if <name 2> does exist, and ask him 
if that file should be overwritten. If <name 2> has a 
different logical unit number than the original file, the 
file will be duplicated on the specified drive. If the 
TESTPROG source file from the above examples is to be saved 
in a file called TEMP, the following command line would be 
used : 

COPY TESTPROG. TEMP 
The file TEMP will be created on the same drive as 
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TESTPROG. naraelyi drive zero. To copy TESTPROS to drive one. J 

one need only specify the logical unit number <:!> after the 
second name. 

The COPY command should be used to move the EDIT, ASM, 
and RASM commands from their separate diskettes onto the 
system diskette in drive zero. Since the names of the EDIT, 
ASMi and RASM commands s^v^ to be kept the same, the second 
name can be omitted completely. All that needs to be 
specified is the logical unit number. Thus, 

COPY EDIT. CM: 1. : 
COPY ASH. CM: 1, : 
COPY RASM- CM: i, : 

mould be the commands that av^ entered if the diskette in 

drive one contained these files. The suffixes "CM" av^ 

explicitly specified since neither the EDIT, ASM. or RASM 
commands ^v^ source programs. 

A similar procedure would be followed to copy any files 
from a diskette in any drive to the system diskette in drive 
zero. If a diskette has been damaged or cannot be used to 
initialize MDOS. it may be placed in another drive in attempt 
to save any files that may be on it. The COPY command should 
be used to save files in this manner. If diskette controller 
errors occur during such a save process, the files cannot be 
recovered. 

If a user has existing files on paper tape or cassette 
that ar^ written in one of the standard record formats (i.e., 
records that end with a carriage return, line feed. null 
sequence — see section 24.3) and which can be read via the 
console reader, the following command line can be used to 
transfer those files to diskette: 

COPY #CR, <name 2>i N 

where <name a> is the name of the diskette file into which 
the tape file is to be written. The first parameter, #CR, 
specifies the console reader device, and the "N" option 
indicates that there is no MDOS header record on the tape 
file. 

The above process can be changed slightly so that a file 
on diskette can be written to the console punch (record) 
device. For example, 

COPY <naffle 1>, #CP; N 



will transfer the file named by <naffle 1> to the console punch 
device. #CP, without the MDOS header information ("N" 
option). Chapter 7 describes in more detail the other 
features of the COPY command. 
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2. B. 10 BACKUP ■ — MDOS diskette creation 



New diskettes/ or diskettes never before used on an MDOS 
system/ must -First be prepared for use uiith MDOS. The 
quickest way to generate a new MDOS diskette is to use the 
BACKUP command. Usually/ a copy is retained of the original 
system aisss^'ce ■cna'c luss snipped wit-o v»«ic E./»wnuiSi. <.« -. *--. 
This diskette should be used to generate subsequent MDOS 
diskettes. It is recommended that the original diskette not 
be used for development purposes. It should serve only as 
the master copy from which all other diskettes are generated. 

A blank or scratch diskette should be placed into drive 
one. The master system diskette should be resident in drive 
zero. The following command line will then cause a complete 
copy of the master diskette to be created: 

BACKUP /• U 

The "U" option specifies that the entire surface of the 
diskette in drive zero is to be read and copied to the 
diskette in drive one. This process ensures that all sectors 
on the new diskette can be written to. Once the BACKUP 
command has been invoked in this way/ it will display the 
following message; 

BACKUP FROM DRIVE TO 1? 

to which the operator should respond with a "Y". Any other 

response will terminate the BACKUP process/ leaving the 

diskette in drive one intact. The "Y" response will cause 
the diskette copy to take place. 

As an added precaution. the two diskettes should be 
compared against each other after the BACKUP command has 
completed. This diskette verification is invoked with the 
following command line: 

BACKUP / UV 

If any messages are displayed during the verification 
process/ the diskette in drive one should not be used as a 
system diskette. 

Chapter 3 describes the BACKUP command in detail. 
Chapter 10 describes an alternative method of generating new 
system diskettes. 

2.9 Other Available Commands 



Several other powerful commands are included with each 
MDOS diskette. These commands avB not needed initially in 
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GENERAL SYSTEM OPERATION ^-^ 

reieroe..^"Abrrer:rsc.iptiono. these co.«ands is given 
here to shed some light on their utility. 

2.9.1 BACKUP — Diskette copying 

The BACKUP command allows making "Pj^^ °%^"*i7 "?°? 
^- ., *4.»= nnfeians exist for making complete copies, i^or 

command. 

2.9.2 EMCOPY — EDOS file conversion 



The EMCOPY command allou^s f i les f rom a user ' s EDOS 2 

..^tei^^is^^^e to b ,.. . -^,,/,-nsr:^tir: drske!:?°^ 

Un:red%iir^rr%i:gle%ire;. ^^pUr .3 contains the 
Complete description of the EMCOPY command. 

2.9.3 BLOKEDIT — File rearrangement 

The BLOKEDIT command allou^s lines of text from one or 
IS^TT^ilts to be selectively copied into a new file. 
?;i TommanJ'':an°be%seful in generating ne. program source 
files bu copying routines from existing source fil", or in 
files '"^ "P'^^"^ . ^iies by copying their lines into a neu» 
reru-cl^"^h:pt::Tcont:!ns%he''com?iete description of the 

BLOKEDIT command. 

2.9.4 LIST — File display 

The LIST command is used to print any ASCII file on 

files can be accessed u, f^%,-=^ "chapter 17 contains 
rapid access to any portion of a file. Chapter 
the complete description of the LIST command. 

2.9.5 MERGE — File concatenation 

The MERGE command allouis one or '"7%/^^", *° Jj 
concatenated into a ne. file. This comman J^-f^^J,,- 

;:T^J:i:2le^n:;:iienr:; SUrTn ^:;n]unction .ith the 
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M6800 Linking Loader. Chapter 19 'contains the complete 
description of the MERGE command. 

2.9.6 BINEX — EXbug-loadable file creation 



The BINEX command allows memory-image files to be 
rcnverted into an EXbug-loadable format for copying to tape^ 
This command performs the inverse operatiorof^^.^^^ 

ror-:is.ette!i^!Lent%oft:::e^itJ^MOOS, since the ob.ect 

^.-: c^nta-r^s: i:.^ ^a^r:^-^-^'^ 

command. 

2 9. 7 FREE — Available file space display 

The FREE command displays how many unallocated sectors 
and hou, many empty directory entries are J" ^\/i^^^!!^^ 
Chapter 16 contains the complete description of the FREE 

command. 

2. 9. S ECHO — Echo console I/O on printer 



The ECHO command can be used on an EXORciser II system 
^n rause all input/output directed to the system console to 
aLo be printed on the line printer. Chapter 12 contains the 
complete description of the ECHO command. 

2.9.9 PATCH — Executable program file patching 

The PATCH command allouis changes to be made to 
memory-Lage files. An object file can be "fixed" due to 

Tnl? bugs or assembly errors -**'-*/--^!2g^*°„;n:s" can 
re-assemble its corresponding source file. The fixes can 
be entered using M6800 assembly language mnemonics or the 



equivalent hexadecimal operation codes. Chapter 21 contains 
the complete description of the PATCH command. 

2. 9. 10 CHAIN — MDOS command chaining 

The CHAIN command allows predefined procedures to be 
automatically executed. A procedure consists of any ^^^^l^^ 
of MDOS command lines that have been put into a diskette 
file Instead of obtaining successive command lines ^'^o"' ^^^ 
console, CHAIN u,ill fetch commands from a file. This feature 
auLs complicated and lengthy operations to be defined once, 
and then invoked any number of times, requiring "° ° ^^J*°^ 
intervention. The additional capabilities of conditional 
JirectWes to the CHAIN command at both compilation and 
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execution time, and the capability of string substitution, 
permits an almost unlimited number of applications to be 
handled by a CHAIN file. Chapter 6 contains the complete 
description of the CHAIN command. 

2.9. 11 REPAIR — System table checking 

The REPAIR command allows the user to check and repair a 
malfunctioning or a non-functioning MDOS diskette. Errors in 
the system tables can be found* identifiedi and corrected 
with this command. Since MDOS performance is directly 
related to the correctness of these system tables, the REPAIR 
command is a useful diagnostic utility. Chapter 22 contains 
the complete description of the REPAIR command. 

2. 9. 12 DUMP — Diskette sector display 



The DUMP command allows the user to examine the entire 
contents of any physical sector on the diskette. The sector 
can be displayed on either the system console or the printer. 
The display contains both the hexadecimal and the ASCII 
equivalent of every byte in the sector. The DUMP command 
allows opening of files so that they can be examined using 
logical sector numbers. Sectors can also be moved into a 
temporary buffer where changes can be applied before they are 
written back to diskette. Chapter 11 contains the complete 
description of the DUMP command. 

2. 9. 13 FORMAT — Diskette reformatting 

The FORMAT command attempts to rewrite the sector 
addressing information on damaged diskettes. The command can 
be used to reformat either single-sided or double-sided 
diskettes; however, double-sided diskettes must be formatted 
with this command before they can be used with MDOS. 
Single-sided diskettes usually come pre-f ormatted in a 
compatible format. The FORMAT command will only work on 
systems that are operating at one of the standard clock 
frequencies of 1 MHz. 1. 5 MHz, or 2 MHz. Chapter 15 contains 
the complete description of the FORMAT command. 

2. 9. 14 DOSGEN — MDOS diskette generation 



The DOSGEN command allows specialized MDOS diskettes to 
be prepared. Diskettes that have bad sectors can have those 
sectors locked out so that the diskette can be used in an 
MDOS environment. DOSGEN will also create all system tables 
and files on the generated diskette. The DOSGEN command can 
be used to generate system diskettes on either single-sided 
or on appropriately formatted double-sided diskettes. 



■ ^ 
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Chapter 10 contains the complete description of the DOSGEN 
command. 

2.9. 15 ROLLOUT — Memory rollout to diskette 

The ROLLOUT command is used for writing the contents of 
memory to diskette. The ROLLOUT command supports w.,s 
dual-memory maps of EXORciser II as well as the single memory, 
map of EXORciser I. Options exist for writing memory 
directly into a diskette file or for writing to a scratch 
diskette. Chapter 23 contains the complete description of 
the ROLLOUT command. 

2. 10 MDOS-Supported Software Products 



Although the preceding list of commands provides the 
user with many powerful tools for software development, there 
are many other Motorola products which are capable of running 
in an MDOS environment. even though they were developed 
independently. These products are called MDOS-Supported 
software products. No attempt will be made in this User's 
Guide to comprehensively describe any MDOS-Supported software 
product. Appendix H contains a list (complete at time of 
publication) of all products that can be invoked from an MDOS 
diskette as a command. Each description will contain the 
additional hardware requirements* if any, the command line 
formats, and a brief discussion of the product's 
capabilities. MDOS-Supported software products will be 
received on separate diskettes. Section 2.8.9 describes how 
such products can be copied onto the system diskette. 

2.11 Paper Alignment 

All MDOS commands that output to the line printer will 
return the paper to its original position upon termination. 
Thus, if the paper is correctly aligned at the time MDOS is 
initialized, then the paper will never have to be aligned 
again. The paper should be placed so that the print line is 
positioned three lines before a perforation (assuming 
fan-fold forms). MDOS commands use the standard format of 66 
lines/page. 
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CHAPTER 3 



BACKUP COMMAND 



The BACKUP command allows making copies of entire MDOS 

diskettes. Options exist for making complete copies* for 

file reorganization to consolidate fragmented files and 

available spacer for appending families of files from one 

diskette to another* and for diskette comparisons. The 

BACKUP command will only copy MDOS-generated diskettes. The 
BACKUP command may also be used for copying single-sided 
diskettes onto double-sided diskettes. 

3. 1 Use 



The BACKUP command is invoked with the following command 
line: 

BACKUP CC: <s-unit>* 3: <d-unit>l C;<options>] 

where <Is-unit> is the source logical unit number) <d-unit> is 
the destination logical unit number* and <options> can be one 
or more of the option letters described below. 

If neither <s-unit> nor <d-unit> is specified on the 
command line* then zero will be used as the source unit and 
one will be used as the destination unit. Specifying only a 
single logical unit number on the command line will cause 
zero to be the source unit and the specified logical unit to 
be the destination unit. Both <s-unit> and <d-unit> must be 
valid logical unit numbers <0-3>* <d-unit> cannot be zero* 
and the two numbers cannot be the same. 

BACKUP will always copy from the source unit to the 
destination unit (unless diskette comparisons are specified). 

If the command line is valid* the message: 

BACKUP FROM DRIVE <s-unit> TO <d-unit>? 

or 

APPEND FROM DRIVE <s-unit> TO <d-unit>? 

will be displayed where <s-unit> is the source unit number 
and .<d-unit> is the destination unit number. In either case* 
a response of "Y" is required if BACKUP is to continue. Any 
other response will return control to MDOS. Further BACKUP 
action depends on the specified options. The options are 
divided into "Main Options" and "Other Options". Main 
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Options are mutually exclusive. That is, only one Main 
Option can be specified on the comffland line at a time. The 
Other Options can be included with the Main Options as 
described in section 3. 6. 

Main Options Function 

none Copy all allocated space to destination 
diskette. 

R Reorganize diskette so that files are 

defragmented and free space is 
consolidated on destination diskette. 

destination diskette. 

V Verify (compare) source and destination 

diskettes. 

Other Options Function 



C Continue if read/write errors occur. 

D Continue if deleted data mark errors 

occur. 

I Change ID sector during copy. 

L Use line printer for bulk of message 

printing. 

N Suppress printing of file names being 

copied. 

S Suppress printing of byte offsets during 

comparisons. 



U 



Include unallocated space in copy/verify 
process. 

Y If duplicate file name existsi delete 

old» copy new. 

Z If duplicate file name exists, suppress 

copy. 

3.2 Diskette Copying 

If no Main Options are specified* then the default 
BACKUP process mill produce a physical sector copy of the 



\ 
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source diskette on the destination diskette. Only the 
allocated space from the source diskette will be copied. The 
allocated space includes all file space and all areas locked 
out in the Lockout Cluster Allocation Table (see Chapter 24}. 
Thus* only liDOS-generated diskettes can be copied using the 
BACKUP commandi since other diskettes will not have an 
allocation table. 

Since only ths allocsted space is copied; the miniRsum 
amount of disk space is copied, and the BACKUP process is 
completed in the minimum amount of time. Sometimes, however, 
it is desirable to obtain a complete copy, and not just a 
copy of the allocated space. In such cases, the "U" option 
can be used to force the copying of unallocated space as well 
as the allocated space. 

A typical BACKUP process dialogue would look like the 
f ol lowing: 

=BACKUP 

BACKUP FROM DRIVE TO 1? 

Y 



and would produce a copy on the destination diskette of the 
source diskette's allocated space. 

If an EXORdisk III system is being used, then the 

destination diskette cannot be a single-sided diskette if the 

source diskette is a double— sided diskette. The error 
message: 

INVALID TO COPY/VERIFY FROM DOUBLE TO SINGLE SIDED 

will be displayed and control returned to MDOS to indicate 
this condition. The opposite, however, is allowed. That is, 
a single— sided diskette can be in the source drive with a 
double-sided diskette in the destination drive. 

3.3 File Reorganization 



After an MDOS diskette has been used for a while, the 
file structure may become fragmented and new files can become 
scattered. The longer a diskette is used in a development 
environment, the more the total system performance may be 
degraded due to increased access time. File reorganization 
is supplied by the BACKUP command and constitutes one way to 
restructure MDOS diskettes, thereby improving the system's 
ef f ic iency. 
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File reorganization improves system e^^-Ficiency 



by: 



1. Consolidating file segmentsi 

2. Packing files more closely together, 

3. Clustering related files together, 
Operator selection to only copy desired files. 
Reducing marginal diskette errors fay retiiritin< 



4. 
5. 

files, 
6. Consolidating directory space. 



File reorganization is specified with the Main Option 
"R" on the BACKUP command line. Thus, 

BACKUP : <s-onit>, : <d-unit>i R 

ij i L,^ vKa BAr«ijp eatnmand to reorqanizs the files on 

the source diskette in drive <s-unit> during the copy to the 
destination diskette in drive <d-unit>. The source diskette 
must be an MDOS diskette. It is unaffected by the 
reorganization. The message 

BACKUP FROM DRIVE <s-unit> TO <d-unit>? 

is displayed before any copying takes place. Unlike the 
complete copy process ujhich ujill proceed immediately after 
^fjg ..y.. response is given by the operator, the reorganization, 
process mill perform the following initialization procedure: 
First the ID sector is copied (and optionally modified if the 
"I" option was specified). Second, the Lockout Cluster 
Allocation Table (LCAT) and the Cluster Allocation Table 
(CAT) are initialized (user locked out sectors ar^ not copied 
during the reorganization process). Third, the directory 
sectors on the destination disk are zeroed. Fourth, the 
Bootblock is copied. Fifth, all of the file names from the 
source diskette's directory av^ read. They ars then soriiea 
into alphabetical order, first by suffix, then by file name. 
After the sorting has been completed the following message 
will be displayed: 

ENTER FILE COPY SELECTION COMMANDS: 

SAVE (S), DELETE (D), PRINT (P), QUIT (Q), NO MORE (CR) 

S. D, P, Q, (CR): 

indicating that the operator must enter file selection 
commands to specify uihich files from the source diskette are 
4.„ he rap^BH to the destination diskette. The first line of 
the message indicates that BACKUP has reached the file 
selection stage. The second line contains the function of 
each file selection command as well as the letter that must 
be used to issue that command. The third line is used as a 
prompt for the current and subsequent- file selection 
commands. 
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Command Letter 






SAVE 



DELETE 



PRINT 



Include a certain file name or family 
of file names from the sorted 
directory in the set of files to be 
copied to the destination diskette. 

Exclude a certain file name or family 
of file names from the sorted 
directory from the set of files to be 
copied to the destination diskette. 

Display the set of file names from 

the sorted directory that are 

eligible to be copied to the 
destination diskette. 



QUIT 



NO MORE 



Q Terminate the BACKUP command and 
return to MDOS. No copying will take 
place; " houjever; the destination 
diskette has been affected due to the 
reorganization option as explained 
above. 

<CR) Entered as a carriage return only. 
, No more commands will be entered. 

The files to be copied have been 
selected. If no file selection 
commands were issued/ all files in 
the sorted directory mill be copied. 
Begin the copy process. 

Both the SAVE and DELETE commands require file names to 
be specified as parameters. The format of the SAVE and 
DELETE commands are the same. except, of course, for the 
command letter: 

•CD or S> <name 1>C, <name 2>i . . . , <name n>3 

The file names specified can contain the family indicator. 
The default suffix "SA" will be supplied if none is 
explicitly entered. For example, the SAVE command: 

S ». CMiEQU, lOCB. * 



will cause the family of files having the suffix "CJ 
file EQU. SA, and the family of files having the name 
be flagged as saved. The DELETE command: 

D A». CM, NOL/ TEST. L» 



lOCB to 



will cause the family of files beginning with the letter "A" 
and having a suffix of "CM", the file NOL. SA. and the family 
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of files named TEST with suffixes beginning with the letter -^ 
"L" to be flagged as deleted. ,/ 

After a SAVE or DELETE comffland has been entered, each 
file name of the sorted directory which has not already been 
marked as "saved" or "deleted" and which matches one of the 
<name i> < i=l to n) will be marked as "saved" or "deleted". 
A 04,-^ -It 4.1. - jsji- — «—-« *»»««• *-Ha SAKJf!^ ni. HPiETE pQauasTuS line 

have been processed^ a new prompt: 

S. D, P. Qi (CR): 

mill be displayed. The operator can then enter further SAVE 
or DELETE cotiwnands as a»ell as any of the other valid commands 
of the BACKUP file selection process. 

Once a command other than SAVE or DELETE is entered one 
of two things happens to the sorted directory. If at least 
one SAVE command has been processed without error, then all 
file names in the sorted directory not marked as "saved" will 
be marked as "deleted". On the other hand, if no prior SAVE 
commands were used, then all file names not marked as 
"deleted" will be eligible for copying (marked as "saved"). 

The QUIT command can be entered at any time in response 
to the file selection command prompt. QUIT will cause the 
BACKUP process to be terminated and control returned to MDGS. 
The file selection commands entered thus far will have had no 
effect on the destination diskette; however, due to the 
reorganization option, the destination diskette will have had 
its basic system tables initialized as described above. 

The NO MORE command, entered as a carriage return only, 
indicates that no more file selection commands will be given 
by the operator. If no file selection commands have been 
entered prior to the NO MORE command, then all file names in 
the sorted directory will be eligible for copying to the 
destination diskette. The copy process will begin. 

The PRINT command will cause all names from the sorted 
directory which have not yet been flagged as "deleted" to be 
printed. The PRINT command also makes it impossible to enter 
further SAVE, DELETE, or QUIT commands. The PRINT command 
has its own sub-command structure that allows deletion of 
file names from the sorted directory. Along with each file 
name and suffix a two-digit, hexadecimal number that 
indicates the position of the file name within the sorted 
directory is displayed. Thus, the output from the PRINT 
command could look like: 
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00 BACKUP . CM 

01 BINEX . CM 

02 BLOKEDIT. CM 



03 


CHAIN 


. CM 


04 


COPY 


. CM 


05 


DEL 


. CM 


06 


DIR 


. CM 


ID 


RLOAD 


. CM 


IE 


FORLB 


. RO 


IF 


EQU 


. SA 


20 


IOCS 


. SA 



The range of numbers %Q7-IZj inclusive* is missing* 
indicating that they have been excluded from the sorted 
directory via prior SAVE and/or DELETE commands. If PRINT 
ujere the first command to be entered* then all file names in 
the sorted directory mould be seen* and the range of numbers 
would be without gaps. 

After the PRINT command has displayed all of the file 
names, a new prompt will be issued: 

DELETE FILE NOS. : 

to which the operator can respond with a number, a series of 
numbers or ranges of numbers separated by commas, a range of 
numbers, or a single carriage return. The numbers must be 
from the set of those displayed in front of the file names. 
These numbers are used to indicate which files avB to be 
excluded from the sorted directory before files are copied to 
the destination diskette. For example, the following entry: 

01-03. IE. 06 

would cause the file names with numbers 

01. 02. 03. 06. and IE 

to be removed from the sorted directory before the file copy 
process begins. Another "DELETE FILE NOS." prompt will be 
displayed if a number was entered in response to a previous 
prompt. Thus, as many file names as desired can be excluded 
from the sorted directory. A carriage return response to the 
prompt has the same effect as the NO MORE command described 
above; i.e.. it will end further command processing and cause 
the file copy process to begin. 

After the files to be copied have been selected, the 
message 

COPYING MDOS . SY 

will be displayed. This message will in turn be followed by 
similar messages for each of the eight remaining system files 
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that must be copied to every diskette. The MDOS family of 
system files ars not shown in the sorted directory since they 
must be copied. These system files ars copied first so that 
they will be assured of residing in specific physical 
locations required by the MDOS initialization process. After 
the MDOS system files have been copiedi the message: 

STARTING TO COPY FILES 

is displayed* foilotued by messages of the form: 

COPYING <name i> 

as each file from the selected files list is copied to the 
destination diskette. 

Using the above example of the sorted directory and the 
file names deleted from it, the file copy messages uiouid look 
like: 

COPYING MDOS . SY 

COPYING MDOSOVO . SY 

COPYING MDOSOVl . SY 

COPYING MDOSOV2 . SY 

COPYING MDOSOVO . SY 

COPYING MD0S0V4 . SY 

COPYING MD0S0V5 . SY 

COPYING MDaS0V6 . SY . 

COPYING MDQSER . SY 
STARTING TO COPY FILES 

COPYING BACKUP . CM 

COPYING COPY . CM 

COPYING DEL . CM 

COPYING RLDAD . CM 

COPYING EQU . SA 

COPYING IOCS . SA 

After all eligible files from the sorted directory have 
been copied. BACKUP will return control to MDOS. The 
destination diskette will contain all of the selected files 
packed together as closely as possible, leaving as much free 
space as possible. 

3.4 File Appending 



The file append process alloius selected single files or 
families of files to be copied from the source diskette to 
the destination diskette. The file append feature of the 
BACKUP command is similar to the reorganization feature 
except that the destination diskette is not initialized with 
new system tables or system files-. Only the file selection 
and the file copying from the source diskette ars performed. 
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The diskette in the destination drive is assufsed to be a 
valid MDOS diskette. The file append process is invoked by 
using the Main Option "A" on the BACKUP command line: 

BACKUP : <s-unit>. :<d-unit>; A 

Instead of the, "BACKUP FROM DRIVE <5-unit> TO <d-unit>?" 
message normally displayed by BACKUP, the message: 

APPEND FROM DRIVE <s-unit> TO <d-unit>? 

is shown. The operator must respond tuith a "Y" if the file 
append process is to continue. Like the file reorganization 
process, the file append process allou/s the operator to 
select which files are to be copied. The messages for file 
selection and the commands to the file selection process ar^ 
explained in section 3.3. File Reorganization, and will not 

■ - !• I j_ u— .... A£4-M«. ^11 £ i T A t^ K9\/o Kaam ^alar^ari^ 

Oe aiSCUSSBQ a^a xn mrie. nrvci ta^* i»^ = = iitars >.&«.• ^.......i.-. 

they will be copied similar to the process described in 
section 3.3; however, the MDOS family of system files is not 
copied. 

Since the destination diskette already contains entries 
in its directory, a possibility of file name duplication 
exists. In the event that one of the selected file names 
from the sorted directory duplicates a file name in the 
destination directory, the following message will be 
disp layed: 

<n3me> - DUPLICATION: IS IT TO BE COPIED? 

The operator must respond with either an "N" or "Y". The "N" 

response will prevent the file from being copied to the 

destination diskette. The "Y" response will cause the 
prompt: 

NEW NAME: 

to be shown, to which the operator can respond with the new 
name that is to be assigned. If a valid file name and suffix 
are entered, they will be used as the name of the destination 
file. The default suffix "SA" will be supplied if none is 
explicitly entered. If only a carriage return is given as a 
response to the prompt, then the file on the destination 
diskette will be deleted (if it is unprotected) before the 
file from the source diskette is copied <which will retain 
its original name. in this case). If the destination 
diskette's duplicate file, cannot be deleted.- the message 

CANNOT DELETE DUPLICATE NAME 

will be displayed and the BACKUP command will be terminated. 

The "Y" and "Z" options can be used in conjunction with 

Page 03-09 



3.4 — File Appending 
the "A" option to indicate an autonvatic procedure in the '"^^ 



event of file name duplication. The "Y" option will 
automatically cause an attempt to be made to delete the file 
on the destination diskette before the copy takes place. If 
the "Y" option is in effect. the file name duplication 
message from above takes on the following form: 

<name-> - Duri-iC«! iuN: la wurf ii^w 

to indicate that a "Y" was given as an automatic response to 
the "IS IT TO BE COPIED?" portion of the message. The "Z" 
option mill cause the file name duplication message to take 
on the form: 

<name> - DUPLICATION: IS NOT COPIED 

to indicate that an "N" was given as an automatic response to 
the "IS IT TO BE COPIED?" portion of the message. 

The file append process causes space to be allocated on 
the destination diskette in contiguous blocks. If 
insufficient contiguous space should remain on the 
destination diskette for a given file, the file mill not be 
copied. The error message 

OBJECT FILE CREATION COPY ERROR 

will be displayed and the BACi^UP command u»ill be terminated. 
The destination diskette may have sufficient space to 
accommodate the filei howeveri if the space is not 
contiguous. the above error occurs. To copy the file, the 
destination diskette should be run through the file 
reorganization process described in section 3.3, or the file 
must be copied via the COPY command <Chapter 7). After the 
last file has been copied to the destination diskette, 
control will be returned to MDOS. 

3. 5 Diskette Verification 



y 



y 



The Main Option "V" invokes the verify process of the 
BACKUP command. The verify process allows a physical sector 
comparison to be made between the diskettes in the source and 
destination drives. The following command line, without the 
presence of other options, will cause the verify process to 
compare the diskettes' physical sectors based on the source 
diskette's allocation table: 

BACKUP : <5-unit>. : <d-unit>i V 

If any bytes in aiiy sectors fail to compare, a sector message 

and a list of ail offsets within the sector that did not ,^ 

compare is printed: ..y 
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SECTOR nnnn 

OFFSET ii DR<s-uni t>-j j DR<d-unit>-k k 

uihers "ii" is the hexadecimal offset into physical sector 
"nnnn"/ "jj" is the hexadecimal contents of the sector's byte 
on the source diskette, and "Vk" is the hexadecimal contents 
of the respective sector's byte on the destination diskette. 
If all sectors compare, no messages are displayed. After the 
,.m-^i a i-s^^ "■" hj»c rnmoleted. control is returned to MDOS. 

If an EXORdisk III system is being used, the destination 
diskette cannot be a single-sided diskette if the source 
diskette is a double-sided diskette. In such cases the 
message 

INVALID TO COPY/VERIFY FROM DOUBLE TO SINGLE SIDED 

mill be displayed and control returned to HDOS. The 
opposite, however, is allowed; that is, a single-sided 
diskette can be verified against a double-sided diskette. 

3. 6 Other Options 



The Other Options described briefly in section 0, 1 
cannot be used indiscriminately with any of the Main Options. 
This section serves to fully explain the use of each Other 
Option. 

Other Valid with Function 

Option Main Option 



any 



any 



The "C" option will cause the copy or 
verify process to continue even if a 
retryable read/write error occurred which 
could not be corrected. The retryable 
errors include CRC, seek, data mark, and 
address mark CRC errors. The "C" option 
will not cause read/write errors on 
Retrieval Information Blocks to be 
ignored. 

The "D" option will cause the copy or 
verify process to continue even if a 
deleted data mark error is detected. 
This option allows the verification of 
diskettes that have had bad sectors 
locked out during the DOSGEN or REPAIR 
process (such sectors are flagged with a 
deleted data mark J. The "D" option 
permits a user to copy the maximum amount 
of data from a bad source diskette to a 
good destination diskette. 
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QthsT Options 



Other 
Option 



Valid with 
Main Option 



Function 



nonei 



R The "I" option indicates that the 
diskette's ID sector is to be modified by 
prompting the operator. The "I" option 
biill cause the foliouiing pronjpt messages 
to be displayed. The operator can enter 
new information if that field of the ID 

changed. If the field is 

same as on the source 

only a carriage return 



;o he 



sector is 
to remain the 
diskette. then 
need be entered. 



' • ■" — r - 



Dneraior Resoonse 



DISK NAME: 



Maximum of eight 

characters for 

diskette ID. Format 

is similar to that of 
a file name. 



DATE(MMDDYY) 



USER NAME; 



Six— digit numeric 
date. No check is 
made for valid months 
or days of the month. 



Maximum of 
characters. 



twenty 



y 



M 



any 



Ri A 



The "L" option causes the output from the 
copy process or from the verification 
process to be directed to the line 
printer instead of the system console. 

The "N" option will suppress the printing 
of the file names as they are being 
copied to the destination diskette. This 
option will not suppress the printing of 
error messages. 

The "S" option will suppress the printing 
of the sector offset messages if sectors 
do not compare. 
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3. 6 



Other Options 



Other 
Option 



Valid uiith 
Main Option 



Function 



U 



none> 



The "U" option indicates that ail 
physical sectors* both allocated and 
unallocated/ are to be copied or 
verified. If "U" is not specified. only 
the allocated sectors< as (napped in the 
source diskette's allocation tabie? ujill 
be used. 



3.7 Messages 



The "Y" option will cause a "Y" to be 
automatically given as a response to the 
file name duplication error message. 
This will automatically force the 
attempted deletion of the duplicate file 
on the destination diskette before the 
file is copied. The "Y" and "Z" options 
are mutually exclusive. 

The "Z" option mill cause an "N" to be 
automatically given as a response to the 
file name duplication error message. 
This will automatically prevent the file 
on the source diskette from being copied 
to the- destination diskette. The "1" and 
"Y" options are mutually exclusive. 



The following messages can be displayed by the BACKUP 
command. Not all messages aTB error messsgesi although error 
messages are included in this list. The standard error 
messages that can be displayed by all commands are not listed 
here. 

BACKUP FROM DRIVE <:s-unit> TO <d-unit>? 

This indicates BACKUP will copy to the 
destination diskette in drive <d-unit> from the 
source diskette in drive <5-unit> if a "Y" 
response is given. Any other response will cause 
control to be returned to MDOS. 

APPE.ND FROM DRIVE <s-unit> TO <d-unit>? 

This indicates that BACKUP will perform the file 
append process if a "Y" response is given. Any 
other response will cause control to be returned 
to MDOS. 
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3. 7 — Messages 

The "I" option has been specified. The operator 
is expected to respond with a new disk ID or a 
carriage return. 



DATE(MMDDYY): 



The "I" option has been specified. The operator 
is expected to respond luith a new date or a 
carriage return. 



USER NAME; 



The "I" option has been specified. The operator 
is expected to ressond with a neas user name or a 
carriage return. 

ENTER FILE COPY SELECTION COMMANDS: 

SAVE CS). DELETE (D), PRINT (P), QUIT (Q). NO MORE <CR) 

S. D, P. <2- (CR): 

The "R" or "A" option has been specified. The 
file selection process is activated. The third 
line shows what the valid responses are. 

Si D. Pj Q. (CR): 

This is a subsequent prompt from the file 
selection process. SAVE and DELETE commands can 
be entered until a P (print)/ Q (q.uit)< or 
carrisge return (NO MORE) is entered. 



SYNTAX ERROR 



This indicates a mistake in a response to a 
question or prompt from the BACKUP command. The 
entire line entered by the operator is ignored 
and a new response must be made. 



STARTING TO COPY FILES 



This indicates that files from the sorted 
directory are starting to be copied CR or A 
option) . 



..,-> 
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3. 7 — Messages 



NO FILES TO COPY 



This indicates that there are no file names in 
the source directory <other than the MDOS system 
files) or that all of the file names from the 
sorted directory have been deleted. No files are 
copied if the "A" option is used. Only the MDOS 
family of system files will be copied if the "R" 

Qpv^wTi IS wSeu. 



<name> NOT FOUND 



This indicates that a file name or a family of 
file names specified by a SAVE or DELETE command 
could not be found in the sorted directory. 



COPYING <name> 



This indicates that the file name 
<name> is being copied to the 
diskette. 



specified by 
destination 



<name> - DUPLICATION: IS IT TO BE COPIED? 

This indicates that the file name specified by 
<name> already exists on the destination diskette 
during the append process. Only a "Y" or "N" is 
accepted as a valid response. 



NEW NAME: 



This message is displayed if a "Y" is given in 
response to the preceding message. It allous the 
operator to assign a new file name to the file 
being copied from the source diskette. A 
carriage return response <no file name) mill 
cause an automatic attempt to delete the 
duplicate destination file to be made. rather 
than assigning a netu name to the source file. 



<naffle> - DUPLICATION: IS COPYING 



This indicates that the file name specified by 
<name> already exists on the destination diskette 
during the append process. The "Y" option caused 
an automatic attempt to delete the duplicate 
destination file to be made before the copy 
continues. 
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<name> - DUPLICATION: IS NOT COPIED 

This indicates that the file name specified by 
<naffle> already exists on the destination diskette 
during the append process. The "Z" option caused 
the file to be skipped. The destination file is 
unaffected. 

OBJECT FILE CREATION COPY ERROR 

This usually indicates that insufficient 
contiguous space exists on the destination drive 
for the file being copied <A option). 
Occasionally, however, it may mean that an error 
(uas detected in the reading or writing of the 
file's Retrieval Information Block or. the 
destination diskette. 

CANNOT DELETE DUPLICATE NAME 



on 



This indicates that the duplicate file name 
the destination diskette could not be deleted due 
to its protection attributes. 



DELETE FILE NOS. 



nn <naflie> 



The PRINT command displays this prompt to allow 
deletion of file names by entering their 
displayed numbers. The prompt tuill be 
redisplayed until a null response (carriage 
return) is given. 



After the PRINT command is chosen during the file 
selection process. a list of all file names 
eligible far copying is displayed. The "nn" is a 
hexadecimal number that indicates the position of 
the name uiith respect to the total sorted 
directory. The <name>» of coursei is the file's 
name and suffix. 



SYSTEM SECTOR COPY ERROR 



SECTOR nnnn 



This indicates that a system sector could not be 
read from or written to. BACKUP cannot continue 
and control is returned to MDOS. 



This indicates that the physical sectors "nnnn' 
did not compare during the verify process. 



-.J 
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OFFSET ii DR<s-uni t>-j j DR<d-unit>-kk 

This indicates which bytes did not compare during 
the verify process. The "ii" is the hexadecimal 
offset into the sector, "jj" is the hexadecimal 
contents of the byte on the source unit <5-unit>. 
"kk" is the hexadecimal contents of the byte on 
the destination unit <d-unit>. 

DIRECTORY READ/WRITE ERROR 

This indicates that an internal system error was 
encountered while trying to access the directory 
of the source diskette. Errors of this type 
indicate a possible hardware problem. 

SOURCE FILE COPY ERROR 

This indicates that an internal system error was 
encountered while reading a Retrieval Information 
Block from a file on the source diskette. Errors 
of this type indicate a possible hardware 
problem. 

INVALID TO COPY/VERIFY FROM DOUBLE TO SINGLE SIDED 

This indicates that on an EXORdisk III. system, 
the source diskette was double-sided while the 
destination diskette was single-sided. This is 
invalid. 



3. B Precautions with BACKUP 



The following sections describe some of the precautions 
that should be taken when using the BACKUP command in the 
various environments that are supported by MDOS. 

3.8.1 BACKUP and the CHAIN process 



Since the BACKUP command has so many different paths 
that can be taken, it is generally recommended that BACKUP 
not be invoked from within a CHAIN process (see Chapter 6). 
The BACKUP process is so important to the protection of 
diskette files that the entire process should be supervised 
by the operavor. 

Diskette verification from within a CHAIN process using 
the BACKUP command is also infeasible. The CHAIN command 
writes intermediate information to the diskette in drive zero 
during its operation. Thus, if BACKUP with the "V" option is 
invoked from within a CHAIN process, and if drive zero is 
involved in the BACKUP process, then the two diskettes ars 
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3. 8 == Precautions with BACKUP 



guaranteed to be different. 

3.8.2 Single/double-sidsd diskettes 

On EXORdisk III systems the BACKUP command can be used 
to ceny or verify from a single-sided diskette (source 
diskette) to a double-sided diskette (destination diskette)} 
howsveri the reverse is not allowed. 

When a single-sided diskette is copied ts a double-sided 
diskette, the system tables <CAT and LCAT) are automatically 
adjusted so that they reflect the true amount of space 
available on the double-sided diskette. When a verify takes 
Blace, the CAT and LCAT will be different between the two 
disXettesi noujever/ no ver xriuai t«Autt ci i wi *^ u**,,*^^^- -. ...- 
allocated parts of the tables are the same. 

3. S. 3 FouT — drive systems 



The BACKUP command has the capability of copying to or 
verifying with any of the three drives (1-3) in a four-drive 
system. It is not possible^ however, for BACKUP to sense the 
difference between a two-drive and a four-drive system. 
Thus, due to the nature of the two-drive disk controllers 
with EXOPd-isk II, it is possible to destroy a diskette in 
drive one if BACKUP is invoked with the "R" option and if 
non-zero numbers avs specified on the command line for 
<s— unit> and <d-unit>. 

If the user has a two— drive system, it does not make any 
sense for him to enter logical unit numbers on the command 
line when invoking the BACKUP command, since the proper 
default is to copy from drive zero to drive one. If he were 
to specify to copy from drive two to drive three with the "R" 
option. then the diskette in drive one would be accessed and 
subsequently destroyed. 

3. 9 Examp les 



Many times it is desirable to differentiate the two 

identical copies of diskettes from each other by use of the 

ID sector information. The ID sector's contents can be 
changed during a diskette copy by using the "I" option. 

=BACKUP i I 

BACKUP FROM DRIVE TD 1? 

Y 

DISK NAME: NEWNAME 

DATE { MMDD YY ) : 1 0978 

USER NAME: V 
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All information to the right of the colons is supplied by the 
operator. The destination diskette will be given the disk 
name NEWNAME which will be printed on the heading lines of 
subsequent FREE and DIR command invocations (see Chapters 16 
and 9/ respectively). The date of the disk copy that is 
generated is January 9* 19781 and the same user name that uias 
assigned to the source diskette during a previous BACKUP or 
during the initial DOSGEN process mill be given to the 
J ^,*..i ^^4.i ^■n ri ■; c i» o + +ra finrfiratorf hu carTiaoe return resoonse 

without any data). 



The verification process using the tu»o diskettes 
generated above will cause an error when comparing the ID 
sectorsi howeveri the remainder of the diskettes are still 
compared. The offset messages of the discrepancies can be 
suppressed by also using the "S" option. Thus* the 
verification of the above example's generated diskettes would 
show the following operator-system interactions: 

=BACKUP 1 VS 
SECTOR 0000 



The following example assumes that no scratch or garbage 
files exist on the source diskette. Then, the reorganization 
process requires a minimum amount of operator interaction: 

=BACKUP : 1, : 2; R 

BACKUP FROM DRIVE 1 TO 2? 

Y 

ENTER FILE COPY SELECTION COMMANDS: 

SAVE (S). DELETE (D), PRINT <P)> QUIT (Q). NO MORE <CR) 

S, D. P. <5/ (CR): 

COPYING MDOS . SY 

etc. 

STARTING TO COPY FILES 

COPYING BACKUP . CM 

etc. 



It should be noted that no file selection commands were used. 
The resulting destination diskette will contain all files 
from the source diskette, but they may be in different places 
on the surface of the diskette. Thus, a reorganization 
process cannot be followed with a verification process for 
the same diskette pair. The "N" option could have been used 
in the above example to suppress the printing of the file 
names as they were being copied. 

The last example shows the file append process. The 
example assumes that there is an MDOS diskette in drive 1. 
Also, it assumes that the diskette in drive zero has a family 
of files which avs to be copied to the destination diskette. 
The family has file names which start with the letters "FOR". 
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3. 9 — Exafliples 



The following shows the operator-systsfli interactions: 

=BACKUP iA 

APPEND FROM DRIVE TO 1? 

Y 

ENTER FILE SELECTION COMMANDS: 

SAVE <S>, DELETE (D)i PRINT (P). QUIT (Q). NO MORE (CR) 

S> D« Pi Qi <CR):S FOR*,* 

Si D. P. Q* (CR):P 

09 FORT . CM 
OA FORTLIB . RO 
OB FORTNEWS. SA 
OC FORTESTl. SA 
OD F0RTEST2- SA 
OE FQRTEST3. SA 
OF FOR TEST 4. SA 

10 F0RTEST5. SA 
DELETE FILE NOS. ; 
B-Ei 10 

DELETE FILE NOS. : 

STARTING TO COPY FILES 

COPYING FORT . CM 

COPYING FORTLIB . RO 

COPYING F0RTEST4. SA 

F0RTEST4. SA - DUPLICATION: IS IT TO BE COPIED? 

Y 

NEW NAME: FTE5T 

The file selection command SAVE tuas used to flag all 
file names beginning u»ith FOR as eligible for copying. Then 
the PRINT command was used to see the eligible list of file 
names. The PRINT command terminates the use of the DELETE 
and SAVE commands. Thus, the PRINT command's delete file 
feature is used to remove any remaining file names from the 
eligible list. File names OB, OC, OD, OE. and 10 mere 
deleted in this manner. A null response is required to 
terminate the PRINT command's input prompting. The last file 
to be copied turned out to have a duplicate file name 
existing on the destination drive. The operator responded 
with a "Y" indicating that he wanted to copy the file anyway. 
Since duplicate file names cannot exist, the append process 
lets the operator rename the source file before it gets 
copied. The new name assigned to the file on the destination 
diskette will be FTEST. SA (default suffix assigned). 



J 



J 
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CHAPTER 4 



EINEX COMMAND 



The BINEX command allows memory-image files to be 
converted into an EXbug-loadab le format for copying to tape. 
This command performs the inverse operation of the EXBIN 
command (see Chapter 14). BINEX is useful in the development 
of non-diskette-resident software uiith MDOS» since the object 
code can be written to tape after it has been tested. 

4. i Use 



line: 

BINEX <name 1>C, <name 2>3 

where <name 1> is the file specification of a memory-image 
file that is to be converted) and <name 2> is the file 
specification of a file that is to receive the results of. the 
conversion. Only <name 1> is required to be entered on the 
command line. The default suffix "LO" and the default 
logical unit number zero will be supplied for ' <name 1> if 
those quantities are not explicitly given. The output file 
specif ication# <name 2>. is optional. If <name 2> is 
entered) it may be a partial file specification consisting of 
only a file name^ a suffix* or a logical unit number < or any 
combination thereof). The unspecified parts of -Cname 2r> will 
be supplied from the respective parts of <name 1>/ with the 
exception of the suffix. The default suffix for <hame 2> is 
"LX" to indicate its EXbug-loadab 1 e format. If no file 
specification is given for <name 2>j the output file will be 
created with the same file name as <name 1> but with the 
suffix "LX". If only a suffix is given for <name 2>. that 
suffix will be used instead of the default "LX". If no 
logical unit number is given for <name 2>j the output file 
wi_ll be created on the same drive as given for <name 1>. In 
any casei <name 2> must be a file specification for which no 
entry already exists in the directory. 

Standard error messages will be displayed if <naffle 2> 
already exists, if <narae 1> does not exist* or if <name i> is 
of the wrong file format. If no errors are found on the 
command line. BINEX will write into the output file a name 
record, or SO record* that contains the file name and suffix 
of <name 2>. Then* BINEX will convert the content of <name 
1> into displayable ASCII characters and outp-ut them to <name 
2> in the form of the EXbug SI records (the "M6800 EXORciser 
User's Guide" contains a description of this record format). 
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4. 1 — Use 



The terminating S*? record will contain the starting execution 
address that was extracted from <name l>'s load information. 

The memory-image file, <name 1>, is unaffected by the 
entire BINEX process. The output file, <name 2>, can then be 
copied to tape (see Chapter 7, COPY Command) for use in a 
non— diskette environment. 

4. 2 Ettot Messages 



No special error messages ars displayed by the BINEX 
command. Only the standard error messages available to all 
commands ars used. 

4. 3 Examples 



Most frequently, the default suffixes and logical unit 
numbers suffice for BINEX operation. The following command 
line 

BINEX TESTPRQG 

mill produce the file TESTPROG. LX on logical unit zero from 
the memory-image file TESTPROG. LO. also on logical unit zero. 

If the output file is to be created on a different drive 
than the input file, but the other default parameters ars 
still to be applied, then only a logical unit number need be 
specified for <name 2> as in the following example: 

BINEX TESTPROG, : 1 

which will create the file TESTPROG. LX on logical unit one. 

If the file to be converted happens to reside on a drive 

other than zero, then that unit number ujill also be the 

default value of the logical unit number for the output file. 
Thus, 

BINEX TESTPROG: 2 

will create TESTPROG. LX on drive two. 

The last example illustrates the explicit naming of an 
output file and input file. In any case involving default 
values of which the operator is uncertain, it is always safe 
to explicitly use the full file specifications. For example, 

BINEX TESTPROG. LO: 0, FILEX. LT: 
will create FILEX. LT on drive zero. 
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CHAPTER 5 



5. BLOK.EDIT COMMAND 



The BLOKEDIT command allows lines of text from one or 

more ASCII files to be seiectively copied into a neuj file. 

This command can be useful in generating new program source 

files by copying routines from existing source files, or in 
rearranging existing files by copying their lines into a neui 
sequence. 

5. 1 Use 



The BLOKEDIT command is invoked with the following 
command line: 

BLOKEDIT <name 1>. <name 2> 

Both of the parameters are required by the BLOKEDIT command. 
<name 1> is the file specification of a command file, and 
<name 2> is the file specification of a neui file which will 
be created. The new file will be written into as directed by 
commands in the command file. 

Both file specifications are given the default suffix 
"SA" and the default logical unit number zero. <nam6 1> must 
be the name of a file that exists in the directory. <name 2> 
must not already exist. A standard error message will be 
displayed if either of these criteria is not metj or if 
<:namel> is of the wrong file format. 

5.2 BLOKEDIT Command File 



The command file specified by <name 1> is the 
controlling factor in the execution of the BLOKEDIT command. 
The command file contains the names of the source files that 
are to be used for the extraction of data, the numbers of the 
lines within a particular source file that are to be copied 
into <name 2,>> commentsi and original text supplied by the 
user that is also to be copied into <name 2>. The command 
file must be creatsd with the EDIT commandi or a similar 
commands prior to using the BLOKEDIT command. 

There ars three kinds of lines that can appear in the 
command file: 

1. Comment lines 

2. Command lines 

3. Quoted lines 
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5.2 — BLOKEDIT Command File 



The three types of lines that comprise the comtnand file are 
discussed in the following sections. 

5.2.1 Coflifflent lines 



A comment line is a line mhose first character is an 

rs 

r 






* THESE THREE LINES ARE BLOKEDIT COMMENT LINES 
» 

The occurrence of comment lines in the command file is 
ignored Sy the BLOKEDIT command. Comaient lines serve only to 
document the cosmnand file. 

5. 2. 2 Command lines 



A command line is recognized by the fact that its first 
character is an uppei — case alphabetic character, a decimal 
digit, or a double quote character. For example. 

FILENAME: 1 
5, 75-eo 



are three valid command lines. 

Command lines luhich begin with an upper-case alphabetic 
character indicate that a source file is being named. Such 
command lines are used to specify from which file the 
subsequent lines are to be copied. A source file can only 
be named by putting its file specification at the beginning 
of a command line. Optionally/ the suffix and/or logical 
unit number cart be specified in the standard format after the 
file's name. The default values of "SA" and zero avs 
supplied automatically if no explicit references to suffix or 
logical unit number are made. 
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5 

12345 

100-364 

12, 15. i-5i 17-200, 5-15, 2, 2 

are valid forms of physical line number command lines. A 
source file's physical line numbers can be printed using the 
LIST command described in Chapter 17. 

5. 2. 3 Quoted lines 



A command line that begins with a double q^uote character 
(") indicates the beginning or the end of quoted lines. Any 
information that appears on the same line as the double q.uote 
is ignored. A t^uoted line is any line bounded by a pair of 
command lines which begin with a double q.uote character. All 

into the netu file, as is. Thus, it is possible to include 
original lines of text that uiill be copied into the new file 
in addition to the physical lines copied from the named 
source files. The following example illustrates the use of 
quoted lines: 

" START OF QUOTED LINE SEQUENCE 
LABEL LDAA #'$FD . SET MASK 

LSRB . 
. STAB TAB +4 

TAB . 
« 

» COMMENTS IN QUOTED LINES GET WRITTEN OUT 
* 

JMP EXIT . 
" END OF QUOTED LINE SEQUENCE 

The first and the last lines of the example will be discarded 
by the BLOKEDIT command. The eight lines in between will be 
written as is into the new file. 

5. 3 Messages 



The following messages can be displayed by the BLOKEDIT 

command. Not all messages are error messages, although error 

messages are included in this list. The standard error 

messages that can be displayed by all commands are not listed 
here. 
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CURRENT SOURCE FILE IS <name> ~^i 

y 

A cammand line containing the name of a source 
file has been processed. The name of source file 
is shown as <name>. This message is used to 
monitor the path of BLOKEDIT through the command 
file. 

DONE. NEW FILE LINE COUNT IS nnnnn 

The command file has been exhausted (end of file 
encountered) tahen this message is displayed. It 
indicates that no more command lines uiill be 
processed. The number of physical lines that 
mere copied into the neu» file is given by the 
decimal number "nnnnn". After this message is 
displayed* control is returned to flDOS. 

** 36 FILE EXHAUSTED BEFORE LINE FOUND 

This message is displayed when the source file 
being read uias exhausted (end of file 
encountered) before a specified physical line 
number was found. This is not- a fatal error, 
The next command line from the command file mill 
be processed. 

** 38 INVALID LINE NUMBER OR RANGE ^ 

This error message can be displayed for several 
reasons. A line in the command file did not 
begin with an asterisk, a double quotei a decimal 
digit (0-9), or an alphabetic character (A-Z), 
and the line u/as not a quoted line. If the 
command line started with a digit, then the 
physical line number had a value outside of the 
range 1- 65535, or the starting number of a line 
number range was greater than the ending line 
number of the range. In any case, this is a 
fatal error. BLOKEDIT is terminated and control 
returned to MDOS. The command line in error is 
displayed prior to this message. 

*■» 39 LINE NUMBER ENTERED BEFORE SOURCE FILE 

This message indicates that the command file 
contained a line with a decimal digit in the 
first position before a source file was named. 
Processing cannot continue, so the BLOKEDIT 
command is terminated. The command line in error 
is displayed prior to this message. 
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5. 4 Examples 

In the foliouing example it is assumed that the three 
saurce files EDIT. SA: 1- ASM. SA: Oi and LOAD. SA: contain some 
special utility subroutines that are to be extracted and 
placed into a neui file UTILITY. SA: 0. The physical line 
numbers of the routines can be determined by listing the 
source files on the console or printer (Chapter 17# _«». 
Command). With that information* the command file 
BLKCMD. SA: is created using the EDIT command: 

* 

» Define the first source file 

» 

EDIT: 1 

176-205 

224-230 

* Define the second source file 

# 

ASM. SA: 

" Insert a PAGE directive to separate routines 

PAGE 

II 

56-BOi 90-101, 150-163 

* 

» Define the last source file 

» 

LOAD 

" Insert another PAGE directive 

PAGE 

II 

27, 2S, 29, 30, 31, 32, 33. 34, 35, 36 

37 

38 

39 

40 

* 

» End of Command File 

•» 

Then, the MDOS command line 

BLOKEDIT BLKCMD, UTILITY 

is used to invoke the BLOKEDIT command. During the 
processing, BLOKEDIT uill display the follouing messages: 

CURRENT SOURCE FILE IS EDIT . SA: 1 
CURRENT SOURCE FILE IS ASM . SA: 
CURRENT SOURCE FILE IS LOAD . SA: 
DONE. NEW FILE LINE COUNT IS 104 
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The new file uiill contain the indicated lines from the 
raspectivs source files. Each set of lines copied from the 
source files has been separated from the next file's set of 
lines by a PAGE directive (causing paging when the UTILITY 
file is assembled). The PAGE directive was inserted using 
quoted lines. 

BLOKEDIT can also be used to rearrange the lines of an 
existing file by copying them in a given sequence into the 
new file. The following command file: 

PROGl 

207-300, 10-206, 1-9 

for example., could be used to shuffle the lines in the source 
file PROGl. SA: 0. Firsts lines 207-300 would be copied into 
the new file. These would be followed by lines 10-206. which 
mould be followed by lines 1-9. 

The last example illustrates an error message displayed 
by BLOKEDIT. The command line in error is displayed prior to 
the error message. The initial five-digit number in front of 
the displayed command line gives the line's physical line 
number within the file <as displayed with the LIST command. 
Chapter 17). 

=BLDKEDIT BLKCMD, TEMPEQU 

CURRENT SOURCE FILE IS EQU . SA: 

00002 -56-34 

** 38 INVALID LINE NUMBER OR RANGE 



The error was caused by an invalid line number range. The 
starting number of a range must be less than or equal to the 
ending number of the range. 
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6. CHAIN COHMAND 

The CHAIN command ailoius predefined procedures to be 
automatically executed. A procedure consists of any sequence 
of MDOS command lines that has been put into a diskette fixg, 
known as a CHAIN file. Instead of obtaining successive 
command lines from the console, CHAIN uiiU fetch commands 
from the CHAIN file. This feature allows complicated and 
lengthy operations to be defined once» and then invoked any 
number of times- requiring no operator intervention. The 
additional capabilities of conditional directives to the 
CHAIN command at both compilation and execution time, and tne 

i..:iji... «£ ^*.^-i-r>n ttiih ct: T r if-h i an. oermit an almost uniimiveu 

number of applications to be handled by a CHAIN file. 

6. 1 Use 

The CHAIN command is initially invoked by the following 
command line: 

CHAIN <name 1> C; <arg 1>. , <arg n>: 

The only required parameter is <name 1>, the file name 
specification of the diskette file that contains the 
procedure definition. The CHAIN file, <name 1>. is given the 
default suffix "CF", permitting the file name to be 
identified in the directory listing at a glance as being a 
CHAIN file The default logical unit number is zero. The 
optional arguments. <arg i> < i = 1 to n), are CHAIN tag 
definitions which can be used to modify the compilation, 
content, or execution of a CHAIN file. 

Two special forms of the CHAIN command line can be used 
to restart an aborted CHAIN process. These command lines are 
shown here, but are described in detail in section 6.6. 

CHAIN N* 
CHAIN « 

CHAIN executes a compilation phase and an execution 
phase In the compilation phase, <name 1> is read from 
beginning to end. An intermediate file, CHAIN. SY: 0, is 
created during the compilation. The intermediate file 
consists of lines to be used in the execution phase of the 
CHAIN process. This file will be automatically deleted upon 
the subsequent successful completion of the CHAIN process. 

During the execution phase, CHAIN basically intercepts 
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the system console input rei^oests so that input can be 
supplied from the intermediate file. Each time an input 
request is made by a command that is invoked by the CHAIN 
process, the next line from the intermediate file uiix^ be 
%s4 and passed to the command. As far as the command is 
concerned, it is receiving its input information from the 
operator at the consols. 

The CHAIN command only intercepts console input via the 
MDOS system function ". KEYIN" <see section 25.2), Therefore, 
only programs <command5 or user-written programs) that use 
this system function uiiU receive their input rrom the 
intermediate file. Programs which contain their own input 
routines, or which use the device independent I/O functions 
<see section 25.3) can be invoked by the CHAIN process, but 
tht subsequent input to those programs must be supplied 
manually via the console. 

The CHAIN command cannot be invoked from within a CHAIN 
process unless it is invoked from the last line _ of the 
intermediate file. An error message will be displayed if 
other types of CHAIN command recursion are attempted. 

The CHAIN command, will continue to supply information 
from the intermediate file until the end of the fiie is 
encountered. If, at that point, the next input request from 
the console is by the MDOS command interpreter, the CHAIN 
process will be properly terminated. MDOS will be re-entered, 
and commands will again be accepted from the operator at the 
console If, however, the end of the intermediate file is 
encountered while a program is requesting console input, then 
the CHAIN process is aborted, an error message is displayed, 
and the currently active program will be stopped. Control 
will then be given to the MDOS command interpreter. 

The diskette in drive zero must remain in drive zero 
throughout the execution of the CHAIN process, even if the 
"CF" file is compiled from drives other than zero. 

6.2 Tag Definition, Assignment, and Substitution 

The CHAIN command line can be parameterized with 
arguments that follow the CHAIN file specification. Each 
argument has the following format: 

<tag>C%<value>7.3 

where <tag> is the name by which the argument is referenced 
within the CHAIN file, and <value> is the value assigned to 
that argument. As many arguments as fit on the command line 
can be specified. Multiple arguments must be separated by 
commas. Tags may be from one to thirty-two characters in 
,gng^}, an-j can contain any displayable character except the 



Page 06-02 



CHAIN COMMAND 6.2. — Tag Definition. Assignment, and Substitution 

period (. ). the comma <. )# the space ( ). or the percent sign 

(%). A tag's value can be any series of displayable 

characters with the exception of the percent sign. A tag is 
given a value by following the tag's name with the value 

enclosed in percent signs. If no percent sign follows a 

tag's name. it is assigned a null value. For example, the 
command line 

CHAIN TFILEi LIST.- DAY%17%j TIMEXOS: 30X 

defines three tags: LIST, DAY and TIME. The tag LIST is 
assigned a null value, the tag DAY is given the value 17; the 
tag TIME is given the value 02:30. 

CHAIN allows two uses to be made of tags. First. tests 
can be performed within the CHAIN file to determine whether 
or not a specific tag has been specified on the CHAIN command 
line. Second. the value of a tag can be substituted for a 
tag's occurrence within the CHAIN file. Thus. using the 
above example. the CHAIN file could contain a test for the 
presence of the tag LIST to determine if the CHAIN process 
will produce output to a printer. The values of the tags DAY 
and TIME could be substituted in one of the heading lines 
that may be produced by the CHAIN process. 

So far in the discussion, the value of a tag has not 
been used. The existence of a tag can be tested regardless 
of a tag's value. A tag's value is substituted for each 
occurrence of the tag's name contained between two delimiting 
percent signs. The following example will illustrate tag 
substitution. If a CHAIN file contains these statements: 

RASM TESTPROG; H7.aPTI0N7. 
PROGRAM ASSEMBLED ON 7.DATE7. 
EXBIN TESTPR0Gr.START7. 

then the tags OPTION. DATE. and START will have their 
respective values put in place of their tag names and the 
delimiting percent signs before each line is written into the 
intermediate file. If no tags were specified for the above 
CHAIN at its invocation, then the following intermediate file 
would be compiled: 

RASM TESTPROGiH 
PROGRAM ASSEMBLED ON 
EXBIN TESTPROG 

If the tags were given initial values via the CHAIN command 
line as: 

aPTI0N7.XLG7.. DATE7.JANUARY 8, 19787.. START'/.; 1000% 
then the following intermediate file would be compiled: 
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RASM TESTPRQGi HXLG 

PROGRAM ASSEMBLED ON JANUARY S. 1978 

EXBIN TESTPROS; 1000 

Tag substitutisn is used here to specify the various options 
for the assembly process, a date for the heading line printed 
during the assemfalyi and the starting execution address for 
the converted objsc-c riis. me use ut waya «.■« »as ,s--s-. 
therefore. is of great importance in the creation of 
cosjplicatsd and general purpose CHAIN files. 

To pass tag values from one CHAIN file to another, a 
forcing character is used. The backslash character (\) is 
used to indicate that the next character of a line is not to 
be tested as a special character (i.e., to see if an operator 
follQujs. or a valid tag). Thus- passing a tag from one CHAIN 
file to another can be done uiith a series of statements like 
the following: 

RASM TESTPRQGj H7.QPTIDN% 
PROGAM ASSEMBLED ON 7.DATE7. 
CHAIN FILE2; START\%7.START7.\7. 

The first and last percent signs of the last line are not tag 
replacement indicators. When the above lines avs compiled, 
the resultant intermediate file will not contain the 
backslash characters. If the value "XLG" is given to OPTION. 
"01.3. 73" to DATE. and ^'j 1000" to START, then the compiled 
CHAIN file would appear as 

RASM TESTPROG; HXLG 

PROGRAM ASSEMBLED ON 01. S. 78 

CHAIN FILE2; START'vCi 10007. 

The value of START would be passed from the first CHAIN file 
to the second CHAIN file. The second CHAIN process can only 
be invoked from the last line of the intermediate file. 

6.3 Compilation Operators 



Two types of CHAIN operators exist which can be used to 
modify the procedure that is performed through the CHAIN 
process: Compilation Operators and Execution Operators. 
Execution Operators are described in section 6.4. 
Compilation Operators permit the operator to parameterize a 
CHAIN file to perform many different procedures. For 
example, a CHAIN file may contain the MOOS command lines to 
assemble an entire system of programs. Based on the CHAIN 
arguments specified on the CHAIN command line, all or part of 
■the system of programs may be assembled. The options for the 
assembly process can also be supplied via a CHAIN argument 
<see example in section 6.7). y 
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All Compilation Operators avs included in the CHAIN file 
along with any other statements. Compilation Operators are 
denoted by a slash (/) appearing in the first column of a 
line. Any number of intervening spaces (including none) can 
be placed between the slash and the operator. If an operator 
is found which is not defined. the CHAIN process will be 
aborted. The following Compilation Operators are defined: 

Operator Function 

* Comment 

IPS Conditional "if set" test 

IPC Conditional "if clear" test 

XIP End conditional 

ELSE Conditional alternative 

ABORT Unconditional CHAIN abort 

6.3.1 Compilation Comments 

If the character following a slash is an asterisk (*). 
then a Compilation Comment is indicated. The remainder of 
the line following the asterisk contains the comment/ which 
can include any displayable characters. Compilation Comments 
are not written into the intermediate file. They arei 
howeveri displayed on the console immediately after they are 
read from the CHAIN file. Compilation Comments are useful in 
communicating to the operator what intermediate file is being 
compiled for execution. The comment lines are only displayed 
if the part of the file containing the comments is being 
compiled into the intermediate file (see next section). 

6. 3. 2 IF operator 

If the characters following a slash are "IF", an IP 
operator is denoted. There may be any number of intervening 
spaces between the slash and the IF operator. This feature 
allows a structured type of CHAIN file to be constructed that 
will show by its physical appearance the range of the 
conditional operators. The IF operator allows a test to be 
made for the existence of one or more tags on the CHAIN 
command line. If the test proves positive, or true, then the 
lines from the CHAIN file following the IF operator will be 
included in the intermediate file (written to the CHAIN. SY 
file). Ifi however, the test proves negative, or false, then 
the subsesiuent lines will not be included in the intermediate 
file. The lines from the CHAIN file will be included or 
excluded following the IF operator until an ELSE or XIP 
operator (explained below) is encountered. 

The IF operator has two forms: IPS and IPC, which stand 
for "if set" and "if clear", respectively. The IPS operator 
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proves positive if any of the tags listed as its operand have -n 
been specified on the CHAIN command line. For example, ,_J 

/IFS LIST 

will prove positive if the tag LIST was mentioned on the 
CHAIN command line. The same test will prove negative if 
LIST did not appear. Likewise* the IF operator 

/IFC DAY 

will prove positive if the tag DAY was not specified on the 

CHAIN command line. The test will prove negative if DAY did 

a^j^t^sar. Multiple IF operators can appear in sequence to see 
if all tags of a certain group were specified. Thus, 

/IFS FLAGl 
/IFS FLAG2 
/IFS FLAG3 

will prove positive only if tags FLAGl, FLAG2, and FLAG3 were 
specified on the CHAIN command line. 

More than one tag can B^r^es^v in the operand field of an 
IF operator. A comma separating tag names on an IF line will 
perform an "inclusive or" function. A period separating tag 
names- on the other hand, will perform an "and" function. j 
The "and" function has precedence over the "or" function. J 
That is, the commas (or) can be thought of as grouping the 
periods (and). For example, the IF operator line 

/IFS FLAGl. FLAG2. FLAG3 

is equivalent to the previous example of three successive IF 
operators. The following line, 

/IFS Fl. F2, FLAG3, TAGl. TAG2. LIST 

which can be thought of as being evaluated by the following 
grouping, 

(Fl and F2) or (FLAG3) or (TAGl and TAG2 and LIST) 

will prove positive if the tags Fl and F2 avs specified, or 
if FLAG3 is specified, or if tags TAGl and TAG2 and LIST are 
spec i f i ed . 

If one IF operator has proven negative, then the 
subsequent lines from the CHAIN file, including other IF 
operators, will be ignored until either a corresponding ELSE 
or XIF operator is found. In this way, the IF operator is 
used to modify the resultant intermediate file. 
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6. 3. 3 XIF and ELSE operators 



Two Compilation Operators can cause the range of an IF 
operator to be ended. The XIF operator marks the end of a 
series of conditionally compiled statements. The ELSE 
operator reverses the sense of the IP's test condition, and 
is used to indicate what is compiled if the test condition is 
rs"t ffl''t. The conditional IF operators can be nested to b 
depth of sixteen levels. The following example shows the use 
of XIF and ELSE: 

/IFS LIST 

LIST TESTFILEiLH 

TEST PROGRAM HEADING LINE 

/ELSE 

LIST TESTFILE 

/XIF 

In this sxamplei the file TESTFILE uiill be listed on the 
printer only if the tag LIST is specified on the CHAIN 
command line. A heading line is also provided within the 
CHAIN file if the LIST tag is used. If, however, LIST is not 
specified, then the ELSE portion of the conditional operator 
will be compiled, causing TESTFILE to be shown on the system 
console instead. 

If the above example were to be written without the ELSE 
operator, one additional IF and XIF operator pair would have 
to be used, as shown: 

/IFS LIST 

LIST TESTFILEiLH 

TEST PROGRAM HEADING LINE 

/XIF 

/IPC LIST 

LIST TESTFILE 

/XIF 

It can be seen that the use of the ELSE operator makes the 
CHAIN file easier to understand. 

Each IF operator roust have a corresponding XIF operator. 
The ELSE operator is available at the option of the user. 
The following example shows how nested IF operators might 
appear in a CHAIN file: 

/IFS Fl 

ASM TESTPROG 

/ IFS F2 

EXBIN TESTPROG 

/ XIF 

/XIF 
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In this case* the tag Fl governs whether or not the file 
TESTPRO© will be assembled. If Fl is specified, then the 
assembly will be performed. Then* if in addition F2 is 
specified on the CHAIN command line* the object file 
conversion mill also take place. The CHAIN file can be used* 
therefore* to perform only the assembly* or the assembly and 
the object file conversion* but not the object file 
conversion by itself. 

If* through the use of the conditional operators, a null 
(empty) intermediate file is generated* then the Execution 
Phase of the CHAIN command will be sicipped. Control will be 
given to the MDOS command interpreter, as if no CHAIN had 
ever been executed. 

A *? A ACnOT rt *% oT* a +■ nT* 



/• 



The ABORT operator provides a way of instantly returning 
to MDOS during a CHAIN file's compilation. No messages will 
be displayed as a result of encountering the ABORT operator. 
It is the user's responsibility to include an explanation for 
the ABORT through the use of Compilation Comments. 

The ABORT operator is typically employed in terminating 
a CHAIN compilation if one or more critical tags have been -^ 
omitted from the CHAIN command line. For example* the ^ 
following CHAIN file will be aborted during the compilation 
phase if both of the tags OPT and FILE are missing. The 
Compilation Comments will indicate the reason for the 
termination: 

/IFS OPT. FILE 

/* GOING TO ASSEMBLE XFILE/i 

RASM XFILEX; 7.6PTy. 

/ELSE 

/» BOTH "FILE" AND "OPT" MUST 3E SPECIFIED 

/» CHAIN TERMINATED 

/ABORT 

/XIF 

6. 4 Execution Operators 

Execution Operators can be used for the dynamic 
adjustment of a CHAIN process while it is being executed. 
Through the use of these operators* the user can set values 
in an error status word maintained by MDOS* test the word* 
and, depending upon the results of the test* skip a portion 
of the procedure. The error status word is accessed by all 
MDOS commands to indicate whether or not they completed their 
function without error. ^ 

All CHAIN Execution Operators arm denoted by the 
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coBSfliercial at-sigr, (S) as the first character of a line. Any 
number of intervening spaces (including none) can be placed 
between the at-sign and the operator. If an operator is 
found which is not defined, the CHAIN process will be 
aborted. The following Execution Operators are defined: 

Operator Function 

» Cofliment 

Operator breakpoint 

SET Set error status word 

TST Test error status word 

JMP Continue sequential processing at label 

LBL Define a label 

CMD Change state of CHAIN input echo 

A A 1 Pi ami-.i nn Comments 



If the character following the at-sign is an asterisk 
(*), then an Execution Comment is indicated. The remainder 
of the line following the asterisk contains the comment- 
which can include any displayable characters. Execution 
Comments are compiled into the intermediate file and are not 
displayed until they are encountered during the execution 
phase. Execution Comments are used to relay information to 
the operator during the actual execution of the intermediate 
file. In conjunction with the Operator Breakpoint (next 
section). these comments also serve as a means of passing 
instructions to the operator for mounting paper into the 
printer, swapping diskettes in drives one, two, or three, 
loading a cassette, etc. 

4. 4. 2 Operator Breakpoints 

A variation of the Execution Comment is the Operator 
Breakpoint. If a period C. ) is used instead of an asterisk 
for the Execution Comment, then the normal Execution Comment 
is displayed; however, instead of continuing with the 
processing of the next line of the intermediate file, the BEL 
(*07) character is sent to the console to alert the operator. 
The CHAIN process then waits for any key on .the keyboard to 
be depressed before continuing. For example, the following 
compiled CHAIN file: 

@» eOING TO ASSEMBLE PROGRAM 
@. TURN ON PRINTER 
RASM TESTPRDGiLXG 

would display the two comments during the execution of the 
CHAIN process. Prior to starting the assembly, however, the 
CHAIN process would pause allowing the operator time to ready 
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the printer. Execution would not resume until after the 
operator had depressed any key on the system console. 

6. 4. 3 Error status uiord 



■--^.-^ 



Among the operating system's resident variables is a 
tu»o-byte error status uiord. Each MDOS command uill set or 
clear a bit within this status uiord to indicate the status of 
the command's completion. The error status word has the 
foil QUI ing format: 



B 



B 



1 



Error 



9 W<( VU9 



Error 



Error Type 



! 

! Bits 0-7 describe 

error 



Error Mask Flag 
Bit B (a-A unused) 

Error Status Flag- 
Bit F (C-E unused) 



Normally* after the completion of each command» all bits of 
the Error Status and the Error Type are cleared (= 0). The 
Error Mask is not affected by MDOS commands. If an error 
occurred during the command* the Ettot Status Flag (bit F) 
will be set by the command. In additionj an Error Type mill 
be set into the lower half of the status word (bits 0—7). 
The Error Type is used to indicate which error was detected 
by the command. 

Usually* the CHAIN process will abort anytime the Error 
Status Flag is set by one of the commands invoked from the 
intermediate file. The Error Mask can be used to inhibit 
CHAIN process aborting due to command errors by setting the 
Error Mask Flag (bit B) to a 1. 

The Execution Operators can affect certain parts of the 
status word. The following symbols are used to refer to the 
various parts of the status word: 
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Word Designator Error Status Word Part 



W 

T 
M 
S 



Whole uiord (bits 0-F) 
Error Type (bits 0-7 5 
Error Mask (hits 8-B ) 
Error Status (bits C-F) 



6. 4. 4 SET QperSkOr 



The SET operator can be used to place a certain bit 
pattern into the system error status word. In particular, 
the SET operator is the only way that the Error Mask Flag can 
be set to inhibit CHAIN process abortions. The MDOS commands 
will only set the Error Status and the Error Type. The SET 
operator has the folloujing format: 

eSETC.. <j>3 i:<value>3 

inhere <j> is the status word designator (explained above) and 
<value> is a hexadecimal number that is to be placed into the 
designated word part. The size of <value> must not be 
greater than the size of the word part into which the it is 
to be placed. If the status word designator is not 
specified/ then W/ the whole word part, will be assumed. . If 
<value> is not specified, then zero will be assumed. As an 
example of the SET operator, the following will set the Error 
Mask Flag (bit B) to inhibit CHAIN process aborting due to 
command execution errors: 

eSET, M a 
SSET, W 800 
eSET 800 

All three forms will set bit B of the error status word; 
however, the last two forms will* in addition, set to zero 
all other parts of the error status word. 

6. 4. 5 TST operator 



The TST operator is used to examine the error status 
word for a particular condition. This operator has the 
following format: 

STSTC,<j>3 <condition> l,<value>l 

where <j> is the status word designator. <condition> is the 
test condition to be performed, and <value> is a hexadecimal 
number that is used as part of the test. 



Use of the TST operator results 
condition based on the test performed. If 



in a true or false 
the result of the 
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test is true, then the next sequential line in the 
intermediate file will be skipped. If the result of the test 
is false, howeveri then the next sequential line m the 
intermediate file will be processed. In other words, a false 
condition has the same effect as if the TST operator was not 
processed at all. 

If the status word designator is not specified, then W, 
the whole word part, will be assumed. The following test 
conditions can be used in the <candition> field of the TST 



operator: 



<condition> Test performed on word part 



PQ Equai to <value> 

NE Not equal to <value."> 

QT Greater than <value> 

LT Less than <value> 

GE Greater than or equal to <value> 

I F Less than or equal to <value> 

BS Bit set (=1) 

BC Bit clear (=0) 



The 



fit^st six tests aT9 the standard relational tests 
for equality, etc., that can be performed with the <value> 
and the designated word part. The last two tests (BS and BC ) 
allow specific bits in the designated word part to be tested 
for being set (BS) or clear (BC). The bits to be tested ara 
indicated by the one bits from <value>. 

The <value> part of the TST operator is a hexadecimal 
number in the range 0-FFFF. The size of <value> must not be 
greater than the size of the word part that is being tested. 
No signed numbers can be used. That is, all comparisons and 
tests are made with positive integers. If <value> is not 
specified, then the default of zero will be used. 

6. 4. 6 JMP operator 



The JMP operator allows skipping lines in the 
intermediate file during its execution. Used in conjunction 
with the TST operator, the JMP operator can be turned into a 
.«=.-■-•*.;-=.»-■< ■,!^f s^^i.^A ^.T.i+-irai s-fepos i -P certain conditions 
are detected during the execution of the CHAIN process. 

The JMP operator has the following format; 

€Jf1P <label> 

where <label> must be defined via the label operator LBL. 
Jumps can only be made in a forward direction. That is, once 
a line has been executed from the intermediate file, it 



y 
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cannot be jumped to with the JMF operatorj even if it has a 
defined label. Jumps to undefined labels or backward jumps 
will cause the CHAIN process to be aborted. 

6. 4. 7 LBL operator 



The LBL operator is used to define a label within the 

CHAIN file. All labels referenced by the JMP operator must 

be defined with the LBL operator. The format of the LBL 
operator is: 

@LBL <lafael> 

where <label> follows the same restrictions placed on tag 
names (section 6.2). Labels that ars multiply defined? 
undefined. or backward references will be flagged as errors 
during the CHAIN compilation phase. 3uch errors will cause 
the CHAIN process to be aborted. 

6. 4. 8 CMD operator 



Normally/ during the execution phase* as commands are 
processed from the intermediate filei each command line is 
displayed on the console. Likewise/ all input requested by 
the command that is supplied from the intermediate file will 
be displayed on the console. The CMD operator can be used to 
suppress console display of all input that originates from 
the intermediate file. The CMD operator has the following 
format: 

eCMD -CON or OFF> 

where either ON or OFF must be specified. The CMD operator 
can be used as many times as needed within the intermediate 
file. Initially during the execution phase, the ON form of 
the CMD operator is in effect. 

6. 5 Messages 



The following messages can be displayed by the CHAIN 
command. The standard error messages that can be displayed 
by all commands are not listed here. The messages are broken 
up into two sections: those that can be displayed during the 
compilation phase, and those that can be displayed during the 
execution phase. 

The following error messages can be displayed during the 
compilation phase: 
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ILLEGAL NESTING OF CHAIN COMMANDS 



A CHAIN command uias found in the intermediate 
file that did not coincide with the last record 
of the file. CHAIN processes can only invoke 
another CHAIN command from the last line of the 
intermediate file. 



SOURCE SYNTAX ERROR 



One of the source lines of the CHAIN file 
contained a backslash (\) as the last character 
of the record, or an illegal tag reference mas 
encountered. 



ILLEGAL OPERATOR 



The operator following a slash (/) was not a 
valid Compilation Operator. or the operator 
following an at-sign <S) was not a valid 
Execution Operator. 



INVALID CONDITIONAL EXPRESSION 



An invalid tag reference or invalid tag separator 
(other than period or comma) was used on a 
conditional Compilation Operator statement. 

INVALID NESTING OF CONDITIONALS 

More than sixteen levels of conditionals were 
used, an unequal number of IPs and XIFs exist, or 
an ELSE operator was used illegally. 

EXECUTION OPERATOR OPERAND ERROR 

The operand of an execution operator was invalid. 

VALUE TOO LARGE FOR FIELD 

A value was specified for the Execution Operators 
SET or TST that was larger than the status word 
part designator allowed. 

END OF FILE REACHED BEFORE LAST XIF FOUND 

The end of the CHAIN file was encountered while 
searching for an XIF operator. Usually this 
indicates an unbalanced number of IFs and XIFs. 



UNDEFINED LABELS FOUND 



A JMP operator referenced a label which was never 
defined with a LBL operator. 
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6. 5 — Messages 



OUTPUT RECORD BUFFER OVERFLOW 



A line from the CHAIN file uias encountered which, 
after the substitution of all tag valuesi 
exceeded eighty characters in length. 

** 48 CHAIN OVERLAY DOES NOT EXIST 

The MODS system CHAIN overlay doss net have an 
entry in the directory. The REPAIR command 
(Chapter 22) should be used to check the diskette 
for other errors. 

The follottiing messages can be displayed during the execution 
phase: 



This message is displayed upon the successful 
termination of a CHAIN process. The next console 
input request will be obtained from the system 
console again. The intermediate file. 
CHAIN. SY: Oi will have been deleted. 

** 01 COMMAND SYNTAX ERROR 

An Execution Operator was encountered that had an 
illegal operand field. 

** 08 CHAIN ABORTED BY BREAK KEY 

The operator depressed the BREAK key during the 
execution phase causing the CHAIN process to be 
aborted. 

»* 09 CHAIN ABORTED BY SYSTEM ERROR STATUS WORD 

The last executed program set an error status 
into the system error status word which was not 
masked by the SET operator. If no SET operators 
are used in a CHAIN file, any error status word 
change will cause the CHAIN process to be 
aborted. 

*» 22 BUFFER OVERFLOW 

The response obtained from the intermediate file 
to an input request exceeded the maximum number 
of characters that were acceptable to the input 
request. 
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** 49 CHAIN ABORTED BY ILLEGAL OPERATOR 

An illegal Execution Operator tuas encountered in 
the intermediate file. 

»* 50 CHAIN ABORTED BY UNDEFINED LABEL 

A JMP operator was encountered uihich referenced a 
label that did not exist (Backward references aTe 
treated as undefined labels). 

*« 51 CHAIN ABORTED BY PREMATURE END OF FILE 

An access to the intermediate file returned an 
gn^}_o.p_f ile condition when an input request uias 

i.1.^^ ...,.» .in^ynlrarl h II * h e CHAIN 

maae oy a pT-ogrsjm i^nac moa *,,»««.-- -^ -•-- — - 
process. All input that is expected by the 
program must be in the intermediate file. 

h. h Resuming an Aborted CHAIN Process 



If a CHAIN process is aborted during the execution phase 
for any reason. the CHAIN process can still be restarted 
Since the intermediate file is not deleted until the CHAIN 
process has been successfully completed, this capability 
eliminates the need to recompile the original CHAIN file. 

The special CHAIN command line: 

CHAIN * 

will restart the execution phase with the 
from the intermediate file (the line that 
For example, if an assembly has been invo 
process for which a duplicate object fil 
process will normally be aborted. The op 
manually delete the duplicate file name an 
process with the above special form of the 

If the failing command can never sue 
line of the intermediate file can be byp 
one used to resume the aborted CHAIN proc 
following special command line: 

CHAIN N* 



line last fetched 
caused the error), 
ked by the CHAIN 
e exists, the CHAIN 
erator could then 
d restart the CHAIN 
command line. 

ceedi the current 
assed/ and the next 
ess by using the 



the next line of the intermediate file has been intended 
i a keyin response for the program (which just failed), then 
le process will generally abort again immediately. By using 



If 
as 

thL r- - , 4. • 

the "N*" form of the special command line several times, 
invalid step can usually be bypassed and the CHAIN process 
resumed at a valid MDOS command line. 



the 



-^ 
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The Error Status Mask and the current state of the CMD 
operator are lost when a CHAIN is aborted. These values 
cannot be restored when an aborted CHAIN process is 
restarted. 

6. 7 Examples 



The following example shows a fairly complex CHAIN file 
that incorporates most of the features described in this 
chapter. This CHAIN file is used to assemble and create 
loadable files of a system of program files that resides on 
multiple diskettes. The primary assumption made is that an 
MDOS system diskette is on drive zero and that the source 
programs will be on drive one (although not all at the same 
time) . 

to the operator if no parameters are supplied. It will also 
display messages that indicate what path the compilation 
phase is taking^ based on the passed CHAIN tags. 

/ IFC ASM. LOAD 

/* 

/» THIS CHAIN REQUIRES AT LEAST ONE OF THE FOLLOWING 

/* PARAMETERS: 

/* 

/* ASM — CHAIN FOR ASSEMBLIES 

/* LOAD — CHAIN FOR PRODUCING MEMORY-IMAGE FILE 

/* 

/* AND ONE OR MORE OF THESE PARAMETERS: 

/* 

/* Dl. D2 — DISK 1 and DISK 2 

/* ALL — ALL FILES ON ALL DISKS 

/* <naroe> — NAME OF FILE 

/* 

/* THE FOLLOWING ARE OPTIONAL PARAMETERS 

/* 

/* OPT — ASSEMBLER OPTIONS 

/* 

/ABORT 

/ELSE 

/ IFS ASM 

/* CHAIN FOR ASSEMBLING PROGRAMS 

/ XIF 

/ IFS LOAD 

/* CHAIN FOR MEMORY-FILE CREATION 

/ XIF 

/XIF 

esET, M a 

/IFS ALL. Dl. PROG 1. PR0G2 

e. INSERT DISK 1 INTO DRIVE 1 ~ DEPRESS ANY KEY WHEN READY 

/ IFS ALL. Dl.PROGl 

/* PROGRAM PROGl 
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/ IFS ASM ■■'^ 

DEL PROGl. RQ: 1 -^ 

RASM NOL. EQU- LIS, PROGl: 1; R%OPT%0=PROGi : 1 

/ XIF 

/ IFS LOAD 

STST, S EQ 

SJflP SKIPPGMl 

DEL PROGi. LO: 1 

RLOAD 

IDON." BASE; CURP=\\«100i LQAD=PR0G1: 1 

QBJA=PRaGl: 1 

CURP=\\*100; LDAD=PR0G1: 1 

MO=#LP; MAPF 

EXIT 

SLBL SKIPPGMl 

/ Air 

/ XIF 

/IFS ALL. Dl/ PR0G2 

/* PROGRAM PRaG2 

/ IFS ASM 

DEL PR0G2. RO: 1 

RASM NOL. EQU/ LIS, PRaG2: 1; R-/.0PTy.0=PR0G2: 1 

/ XIF 

/ IFS LOAD 

@TST,S EQ' 

@JMP ENDl -^ 

DEL PR0G2. LO: 1 'J 

RLQAD 

IDON; BASEi CURP=\\«100i LaAD=PR0G2: 1 

0BJA=PRaG2: 1 

CURP=\\$100;LaAD=PR0G2: 1 

MO=#LP; MAPF 

EXIT 

©LBL EMDl 

/ XIF 

/ XIF 

/XIF 

/IFS ALL/ D2. PR0G3, PR0G4 

a. INSERT DISK 2 INTO DRIVE 1 — DEPRESS ANY KEY WHEN READY 

/ IFS ALL, D2, PR0G3 

/» PROGRAM PROGS 

/ IFS ASM 

DEL PROGS. LX: 1 

RASM PROGS: li XOPT"/. 

/ XIF 

/ IFS LOAD 

STST. S EQ 

SJMP SKIPPGM3 

DEL PROGS. LO; 1 

EXBIN PROGS: 1 

SLBL SKIPPGM3 

/ XIF 

/ XIF .J 

/ IFS ALLi D2, PRuG4 
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/* PROGRAM PR0G4 

/ IFS ASM 

DEL PR0G4. LX: 1 

RASM PR0G4: li %0PT7. 

/ XIF 

/ IFS LOAD 

STST, S EQ 

ejMP END2 

DEL PR084. LQ: 1 

EXBIN PR0G4: 1 

SLBL END2 

/ XIF 

/ XIF 

/XIF 

The tags ALLi Dl/ D2, PRDGl/ PROG2, PR0G3, and PROG4 are 
used to identifu uihich programs from the system of programs 
are to be selected by the CHAIN process. All programs from 
all diskettes can be selected by specifying ALL. A specific 
program can be selected by specifying its name: either 
PROGl/ PR0G2. PR0G3i or PR0G4. Ail programs on a specific 
diskette can be selected by specifying Dl or D2. 

The tags ASM and LOAD are used to select iuhat process 
the programs will go through. ASM specifies the programs 
will be assembled. LOAD specifies link/loading or object 
file conversion via EXBIN. 

It should be noted that nested IFs have been indented 
(spaces between slash and IF) to indicate their level of 
nesting. This is optional/ but makes the CHAIN file easier 
to understand. Prior to the assembly and link/load or object 
file conversion processes) a DEL command has been placed to 
ensure that the output file from the process does not exist. 
The first time that the CHAIN file is usedi the DEL command 
will cause an error to occur; however/ the SET operator has 
been used to inhibit CHAIN process aborting. 

The TST operator is used after each assembly process to 
check for errors. If an error occurred/ then the error 
status word will be non-zero in the portion indicated by the 
"S" designator. Thus* the test condition for being equal to 
zero will be false, causing the JMP to be executed. 
Therefore! if assembly errors occur* the link/load or object 
file conversion process will be bypassed since it would only 
generate an unusable file. 

It should also be noted that the backslash character is 
used in the RLOAD command CURP. Thus, the CHAIN forcing 
character, which is also a backslash, must be entered. 

The Operator Breakpoint is used to pause the CHAIN 
process. This allows the operator time to insert the proper 
diskette into drive one. Otherwise, if all programs from all 

Page 06-19 



CHAIN COMMAND 6- ^ "~ Examples 

diskettes were to be assembled, there might not be sufficient ~\ 
time for the operator to swap diskettes. .-^ 

The following example illustrates what is displayed on 
the system console ufhsn the CHAIN is invoked without any 
parameters. Since this would produce an empty intermediate 
file, the condition is tested for and an appropriate message 
displayed. The name of the CHAIN file in the directory is 
SYSGEN. CF. 

=CHAIN SYSGEN 
THIS CHAIN REQUIRES AT LEAST ONE OF THE FOLLOWING 
PARAMETERS: 

ASM — CHAIN FOR ASSEMBLIES 

LOAD — CHAIN .^QR PRODUCING MEMORY- 1 MAGE FILE 

AND ONE OR MORE OF THESE PARAMETERS: 

Dl. D2 — DISK 1 and DISK 2 
ALL — ALL FILES ON ALL DISKS 
<name> — • NAME OF FILE 

THE FOLLOWING ARE OPTIONAL PARAMETERS 

OPT — ASSEMBLER OPTIONS 



The next example uses the same CHAIN file again; 

however. this time the parameters for assembling (ASM), 

memory-image file creation (LOAD), and processing all files 
in the system (ALL) ar^ specified. In addition, the options 

field of the assembler will be initialized with the value 

"LX" to produce a listing and a cross reference table on the 
line printer. 

=CHAIN SYSGENj ASM, LOAD, ALL, OPT^LX'/. 

CHAIN FOR ASSEMBLING PROGRAMS 

CHAIN FOR MEMGRY-FILE CREATION 

PROGRAM PROGl 

PROGRAM PR0G2 

PROGRAM PR0G3 

PROGRAM PR0G4 
SSET FOFF OSOO 
S. INSERT DISK 1 INTO DRIVE 1 ~ DEPRESS ANY KEY WHEN READY 

DEL PROGl. RO: 1 

PROGl . RO: 1 DELETED 

RASM NOL, EQU, LIS, PROGl: 1; RLX0=PR0G1: 1 

MDOS MACROASSEMBLER 03. 00 

COPYRIGHT BY MOTOROLA 1977 



STST, FOOO 0000 0027 
€JMP 2F29 



Page 06-20 



CHAIN COMMAND 



6. 7 — Examples 



DEL PR0G2. RG: i 

PR0G2 . RO: 1 DELETED 

RASM NOL, EQU, LIS, PR0G2: 1; RLXD=PR0G2: 1 

MDOS MACROASSEMBLER 03. 00 

COPYRIGHT BY MOTOROLA l*??? 

STST, FOOO 0000 0027 

gJMP 2F33 

(k- INSERT DISK 2 INTO DRIVE 1 — DEPRESS ANY KEY WHEN READY 

DEL PROGS. LX: 1 

PR0G3 . LX: 1 DELETED 

RASM PROGS: 1; LX 

MDOS MACROASSEMBLER 03. 00 

COPYRIGHT BY MOTOROLA 1977 

eTST, FOOO 0000 O027 

SJMP 2F41 

DEL PR0G4. LX; i 

PR0G4 . LX : 1 DELETED 

RASM PR0G4: liLX 

MDOS MACROASSEMBLER 03. 00 

COPYRIGHT BY MOTOROLA 1977 

€TST, FOOO 0000 0027 
eJMP 2F4B 
END CHAIN 

From the example above, it can be seen that even though 
the LOAD parameter u*as entered on the CHAIN command line, the 
process to create memory-image files was not performed. This 
resulted from the fact that the assembly process generated 
errors in each program. Had no errors occurred, the 
memory-image files would have been created. The operands of 
the Execution Operators have been converted into hexadecimal 
codes during the compilation to make it easier for the 
execution phase overlay to process the intermediate file. 

The last example uses the same CHAIN file again; 
however, this time only a single program is processed, PROGS. 
The operator does not need to know on which diskette this 
program resides. The Operator Breakpoint is used to notify 
the operator when a diskette is to be inserted into drive 
one. In this example, no errors occurred during the assembly 
process since the memory-image file is created. 
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-CHAIN SYSGEN; ASM- LOAD, PRQG3, aPTy.LN=1207. 

CHAIN FOR ASSEMBLING PROGRAMS 

CHAIN FOR MEMORY-FILE CREATION 

PROGRAM PROGS 

eSET FOFF 0800 

S. INSERT DISK 2 INTO DRIVE 1 — • DEPRESS ANY KEY WHEN READY 

DEL PROGS. LX: 1 

PR0G3 .LX: 1 DELETED 

RASM PROGS: li LN=120 

MDOS MACROASSEMBLER 03. 00 

COPYRIGHT BY MOTOROLA 1977 

STST/ FOOO OOOO 0027 

DEL PROGS. LO: 1 

PRQG3 . LQ: 1 DELETED 

EXBIN PROGS: 1 

SLBL 2F29 

END CHAIN 



..y 
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7. COPY COMMAND 

The COPY command allows files to be copied from one 
diskette to another, from a diskette to another device, or 
from another device to a diskette. It is not possible to 
copy files between two non-diskette devices with the COPY 
command. Options exist for copy verification and for the use 
of non-standard devices. 

7. 1 Use 



The COPY command is invoked with the following command 
line: 

COPY <name 1>C, <name 2>3 CJ<options>3 

where <name 1> is the name of a source file or source device. 
<name 2> is the name of a destination file or destination 
device, and <optiQns> may specify the type of copying that is 
to be performed. The fallowing options srs valid. Their use 
is described- explicitly in the next sections: 

Option Function 



B Perform both the copy and the verify 

processes when copying between two 
diskette files. 

C Use binary record conversion during 

the copy to a non-diskette device. 

D=<name 3>C, 3 Use a user-defined device driver 

instead of a standard MDOS-supported 

device driver during the copy or 

verify process. The driver is 

located in a diskette file <name 3>. 

L List errors on the line printer 

during file verification. 



M 



N 



Go to debug monitor after loading 
usei — defined device driver file. 

Use non-file format mode for the 
non-diskette device. 
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V Verify source and destination files. 

No copy is performed. 

W Use automatic overwrite if 

destination file already exists on 
diskette. 

7.1.1 Diskette-to-diskette copying 

In order to copy one diskette file into another^ both 
<na(ne 1> and <name 2> must be specified. The source file 
name specification. <name 1>- will be supplied with the 
default suffix "SA" and the default logical unit number zero 
if those quantities are not explicitly given. The 
destination file na.me spec if ication> <name 2>. need only be 
specified" "with" a file name, a suffix, or a logical unit 
number < or any combination thereof)i houiever, at least one 
03,,^ 0^1 <naffle 2>'5 file name specification must be entered. 
The unspecified parts of <name 2> mill be supplied from the 
respective parts of <name 1>. Thus, if TESTPROG. SA: is to 
be copied to the diskette on drive one. then only the logical 
unit number ' need be specified for <name 2>, since the file 
name and suffix will be supplied from <name 1>: 

COPY TESTPROG. : 1 

In this example the default values were first supplied for 

<name 1>. and then the default values supplied for <name 2>. 

There is no restriction in file format when copying from one- 
diskette file 'into another. 

Only the "B", "L"> - "V" and the "W" options avs valid 
uihen copying between two diskette files. The "V" and "B" 
options, as well as the "V" and "W" options, srs murualiy 
exclusive. The "L" option is valid only valid with "V or 
"B" The "W" option is used to allow the destination 
diskette file to be overwritten if its file name already 
exists. If. in the above example, the file name 
TESTPROG. SA: 1 already existed, then COPY would have displayed 
the message 

TESTPROG. SA: 1 EXISTS. OVERWRITE? 

. i. - ««, = „„, 4s_~-. *.h= as0-^st"-r A "Y" response would 

ano atuai t a response riOm »••= opH.sa--.. =r 

allow the COPY process to continue, and the file on drive 1 

uould be overwritten. Any other response would cause the 

COPY command to be terminated, and the destination file would 

be unaffected. The "W" option's presence will force the COPY 

command to attempt the copy if the destination file name 

exists, without prompting the operator. 

The other options are explained in subsequent sections. y 
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7.1.2 Diskette-to-device copying 



If a diskette file is to be copied to another device* 

both <name 1> and <name 2> must be specified on the command 

line. The default assumptions for the source file are the 
same as in diskette-to-diskette copying* however. <name 2> 

must now indicate a destination device rather than a file. 

The follo'i'in" are valid device specifications that can be 
used for <name 2>: 

Device 

Name Associated Physical Device 



#CN Consols printer 

#CP Console punch (record) device 

#LP Line printer 

#UD User— defined device 

Unlike diskette~-tQ-d iskette copying. uhers <name 1> 

could be the name of any diskette file* <name 1> can only be 
an ASCII or binary record file (see section 24.3). Thus, not 

every diskette file can be copied to a non-diskette device. 

If memory-image files are to be copied to a non-diskette 

device, then they must first be converted via the BINEX 
command (Chapter 4). 

There are two modes for copying files to a non-diskette 
device: file format mode and non— file format mode. The file 
format mode is the default mode that the COPY command uses. 
The file format mode will write one extra record to the 
device before any data records are copied from the file. 
This special record is called the File Descriptor Record 
(FDR) and serves the same purpose as a directory entry for 
diskette files: the FDR contains the diskette file's name, 
suffix and file format (see section 24.3). The "N" option 
inhibits the writing of the FDR to the output device, and is 
used to indicate the non-file format mode. Thus, if an FDR 
is to be written to the output device, the "N" option should 
be omittedi if an FDR should not be written, the "N" should 
be specified. 

The output devices #CN and #LP can be used as the 
destination device in the diskette-to-device copy mode. 
However, the presence of the "N" option on the command line 
when copying to these devices has no effect. The #CN and #LP 
devices are not "file" devices since no FDR could ever be 
read from them. Thus, the COPY command will automatically 
force the non-file format mode to be in effect and suppress 
the writing of the FDR. 

Some output devices cannot support eight-bit binary 
data. In such instances, the "C" option must be used when 
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binary record files are being copied. The "C" option will ,'"^^ 
cause the binary data to be converted into seven-bit ASCII ,' 
data (see section 24.3) which can be handled by the device. 
The following table shows what the destination file format 
mill be» based on the file format of the source file and the 
options specified: 

Source File Destination File 



ASCII ASCII. 

Binary, no "C" Binary, if supported by device. else 

ASCII-converted-b inary. 

Binary. "C" ASCII-converted-binary. 

In the nan-file format mode ( "N" option specified), only 
ASCII record files can be copied. 

The "V* and "L" options sre valid in this copy mode. 
The "W" and "B" options are invalid since no diskette file is 
being written to. The "D" and "«" options can be used, but 
only if the device #UD is specified for <name S> (see section 
7.2). 

7. 1.3 Device-to-diskette copying 



If a file is to be copied from another device to the 
diskette. then <name 1> is required; however, depending on 
the copy mode chosen (file format or non— file format) <naine 
2> is optional. If the file format mode is to be used (no 
"N" option specified), then <name 2> can be omitted. In such 
cases. the file name to be used for the diskette file is 
taken out of the FDRi however. if <name S> is specified 
(still no "N" option), the source device will be read until 
an FDR is found that matches <name 2> before the copy takes 
place. In other words, in the file format mode. <name 2> 
indicates the name of the file on the device which will be 
copied to diskette. The name of the file can only be changed 
with the NAME command (Chapter 20) after the file has been 
copied to diskette. 

If the "N" option is specified, then no FDR processing 
will be performed. Therefore. <naffle 2> must indicate the 
diskette file that is to be written to. 

In either case ("N" option or no "N" option). <name 1> 
will specify the source device, and <name 2> will specify the 
destination diskette file. The default values "SA" and zero 
will be supplied for <name 2>'s suffix and logical unit 
number. respectively. if they are not explicitly entered by 
the operator. The valid device specifications that can be 
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used for <name 1> are: 



Device 

Name Associated Physical Device 



#CR Console reader device 

»UD User-defined device 

#HR EXORtape (see section 7.6) 

Only ASCII record files can be copied using the "N" 
option. If paper tapes or cassettes have been generated in a 
non-MDOS environment, they must conform to the MDQS format 
for ASCII record files (section 24.3). Most important is the 
record termination sequence. Each record must end with a 
carriage return, line feed, and null character combination. 

f->j.t ■-3S, lead in" data characters from the subsequent record 

can be dropped. Next, in importance is the end-of-file 
indicator. The tape should contain the ASCII end-of-file 
record (section 24.3) or generate a timeout condition 
(section of erased or blank tape) to cause the console reader 
to stop. 

If binary records are to be copied, then the file format 
mode must be used. The binary record copied to diskette u/ill 
always be in the binary format, never in the 
ASCli-converted-binary format. The FDR contains the format 
of the file on the device. Thus, the conversion from 
ASCII-cpnverted-binary to binary is performed automatically. 
The "C" option, therefore, is invalid with this form of the 
COPY command. 

The "W" option can be specified to automatically 
overwrite the diskette file (<name 2>) if it already exists. 
The "D" and "M" options are only valid if <naffle 1> is the #UD 
device. The "B" option is invalid, but the "V" and "L" 
options are valid. The "L" option can only be specified if 
"V" is specified. 

7. 1. 4 Verification 



The "V" option can be used to compare tu»o files against 
each other. No file copying tuill take place if this option 
is specified. The "V" option is valid with all three modes 
of the COPY command: diskette-to-diskette, 
diskette-to-dsvice.. and device-to-diskette. If, however, a 
device specification is being used for either <name 1> or 
<name 2>. it must be a device that supports input. For 
example, even though a file from diskette can be copied to 
the line printer or the console punch, the "V" option is 
invalid for those specific devices. 

The verification process will display the message 
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VERIFY IN PROGRESS ,'* \ 

while the verification is taking place. If the files being 
compared are both diskette filesi then the parts of the files 
that do not compare will be displayed in the following 
format: 

SECTOR nnnn 

OFFSET XX SRC-yy DST-zz 

inhere "nnnn" is the logical sector number of the file. "xx" 
is the offset into the sectori "yy" is the source file's byte 
(<naffie 1>). and "zz" is the destination file's byte (<name 
2>). All values ate displayed in hexadecimal. 

T £ nAin<.>^ia — r mam a f^ i 1 ae 2T>fl h s i nil F'nflin^'r^fli then the 

files' RIBs mill also be included in the verify process to 
ensure that the load information matches. 

In the event that only a sector number is displayed 
during the verify process (no byte discrepancies shown), then 
the tuio files are of different lengths. The files ^rs 
identical through the end-af-file of the shorter file. The 
sector number displayed is one sector beyond the end-of-file 
of the shorter file. 

When verifying a diskette file with a non-diskette file, 
the mis-comparisons between the two files are displayed in a 
slightly different format as shown below: 

RECORD mmmmm 

OFFSET kkk SRC-yy DST-zz 

where "mmmmm" is the physical record number in the diskette 
file <in decimal). "kkk" is the offset within the record 
(also in decimal). and "yy" and "zz" aTe the same as 
described above. If the two files being compared are of 
different lengths, and if they ars ' identical through the 
end-of-file of the shorter file, then the offset portion of . 
the error message will not be printed. 

The "L" option can be used in conjunction with the "V" 
option to cause the mis-comparisons between the two files to 
be printed on the line printer instead of the console. 

7. 1. 5 Automatic verification 



The "B" option can be used when copying from one 
diskette file to another to automatically cause the two files 
to be verified after the copy has taken place. Section 7. 1. 1 
describes the copy process between two diskette files. 
Section 7.1.4 describes the verification process. 
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For example, the follou/ing command line: 

COPY TESTPROG, : i; B 

performs exactly the same function as the following two 
command lines: 

COPY TESTPROG, : 1 
COPY TESTPROG, : li V 

The "L" option can be specified along with the "B" 
option to cause any errors during the verification process to 
be printed on the line printer instead of the console. 

7.2 User-Defined Devices 



The COPY command allows the user to specify his own 
device drivers. Such device drivers must follou/ the 
specifications described in this section. The device name 
#UD is used on the COPY command line to indicate that a 
user-defined device driver is specified in the options field. 
The "D" option is used to pass the file name of the device 
driver to the COPY command. The "D" option has the following 
format: 

D=<:name 3>Cj 3 

where the terminating comma is optional. If the "D" option 
is the last option specified, then the comma need not be 
supplied; however/ if other options follow the "D" option, 
then the comma must be present to serve as a terminator for 
the file name specification of the device driver. 

The device driver must be in a file that has the 
memory-image format. <name 3> is a complete file name 
specification. The default values of "LO" and zero will be 
supplied for the suffix and for the logical unit number. The 
device driver roust meet the requirements set forth in section 
26.2 for entry points, for calling sequences, and for return 
conditions. In addition. the following 
satisfied: 



criteria must be 



1. The first twelve bytes of the device driver 
must contain the Controller Descriptor Block 
(CDB) for the device (Chapter 26). 

2. The device driver must not overlay the COPY 
command. It is suggested that the device 
driver load as close to the end of the COPY 
command as possible. This address should be 
$3000. 
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It may be necessary to set breakpoints in the -" "^ 
user-defined device driver to ensure that it is working 
properly The "M" option uiil cause the COPY command to 
enter the debug monitor after the device driver has been 
loaded into memory. This feature is especially useful during 
the initial testing of the device driver. 

The "M" option cannot be used uiithout the "D" option. 
If the "M" option is present, the debug monitor will display 
one' of the following messages depending on the version of the 
EXbug firmware. The first message is displayed by EXbug 1> 
the second by EXbug 2: 

BKPT ERROR 

P-2126 X-2161 A-OD B-SO C-CO S-226F 

It 

SWI p-2126 X-2161 A-OD 3-30 C-CO S-226F 
»E 

These messages indicate that the user-defined device driver 
has just been loaded into memory. The actual numbers in the 
pseudo-registers may differ and are inconseq.uential. The 
pu-^pose of going to the debug monitor is to allow the user to 
set breakpoints, at critical places in t.he device driver to 
verify that it is working properly. After the breakpoints 
are set. control' is .returned to the COPY command by entering 



the EXbug command 



;P 



Then. when the user-defined device driver is accessed by the 
COPY command, the set breakpoints will allow the user to 
check the device driver's functions. 

7. 3 COPY Mode Summary 



The following table summarizes the requirements for the 
three COPY command modes. The following symbols are used in 

the table: 

Symbol Meaning 



DK-DK Diskette-to-diskette copying 

DK-DV Diskette-to-device copying 

DV-DK Device-to-diskette copying 

R Req,uired 

Optional 

F File name 

D Device name 
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COPY 
Mode 



Valid 
Options 



<name 1> <name 2> 



Restrictions 



DK-DK B.L, V, W 



R. F 



Ri F V and W options are 
mutually exclusive. V 
and B options ave 
mutually exclusive. 
L is onlij valid ujith 
V or B. 



DK-DV 



C, D, L, M, N. V 



R,F 



DV-DK 



D, L, M, N. V, W 



R, D 



R, D N option implies 
ASCII record format. 
C option implies 
binary record format. 
D option implies #UD 
device nanis. v 
option implies input 
device. L option is 
only valid with V. 

0, F D option implies #UD 
device name. V 
option implies input 
device, W and V 
option^ are mutually 
exclusive. N option 
requires <riame 2>. 
<nao»e 2> causes 
search for FDR on 
device if no N 
option. L option is 
only valid with V. 



7. 4 Messages 



The following messages can be displayed by the COPY 

command. Not all messages are error messagesi although error 

messages are included in the list. The standard error 

messages that can be displayed by all commands are not listed 
here. 



<name> EXISTS. OVERWRITE? 



The file name! 

directory. Before overujriting 
operator must respond with a 
response will terminate the COPY 



by <name> already exists in the 

the file. the 
"Y". Any other 
command. 



VERIFY IN PROGRESS 



The "V" or "B" option was specified on the 
command line. The two files are being compared. 
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SECTOR nnnn 



7. 4 — Messages 



j 



Tuio diskette files did net compare during the 
verify process. "nnnn" indicates the logical 
sector number (hexadecimal) o-P the failure. 

RECORD mmmmm 

Tuio files did not compare during the verify 
process. One file is on diskette.- the other file 
is not. "mmmmm" indicates the physical record 
number (decimal) in the diskette file inhere the 
failure occurred. The LIST command (Chapter 17) 
can be used to display the records in a file with 
their physical record numbers. 

OFFSET <xx or kkk> SRC-yy DST-22 

This message indicates which bytes within a 
logical sector or within a physical record of the 
two files being compared do not match. The 
offset "XX" is hexadecimal if comparing diskette 
files. The offset "kkk" is decimal if comparing 
a diskette file with a non-diskette file. The 
byte in the source file is shown as "yy". The 
byte in the destination file is shown as "zz". 

7. 5 Examples 



The following examples have been separated into the 
three COPY modes as illustrated in the table of section 7.3. 

7. 5. 1 Diskette-to-diskette example 



The following command line 

COPY PROGS. RO: 2i . RN: 1 

will copy the file PROGS. RO from drive two into the file 
PROGS. RN on drive one. A user response is required to 
continue the copy if the file on drive one already exists. 
The user response can be suppressed* regardless of whether 
the file en drive one exists, by adding the "W" option as 
shown: 

COPY PROGS. RO: 2i . RN: 1 i W 

No error results if the file on drive one does not exist. In 
either case, if the logical unit number had been omitted from 
the <name 2> specification, the file would have been created 
on drive two. ,_/ 
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The next example illustrates the display of the bytes 
which do not compare when two files are compared with the "V" 
option. 

=CQPY BLAKJACK: li : 0; V 

VERIFY IN PROGRESS 

SECTOR 0000 

OFFSET 10 SRC-31 DST-02 

OFFSET 11 SRC -34 DST-03 

OFFSET 12 SRC-2B DST-04 

OFFSET 13 SRC-54 DST-05 

OFFSET 14 SRC -53 DST-06 

OFFSET 15 SRC-31 DST-07 

OFFSET 16 SRC-38 DST-08 

OFFSET 17 SRC-OD DST-09 

OFFSET IS SRC-2B DST-00 

OFFSET 76 SRC-45 DST-55 

OFFSET 77 3RC-4C D5T-66 

OFFSET 78 SRC-53 DST-77 

OFFSET 79 SRC-45 DST-88 



7.5.2 Diskette-to-device example 

The fallowing command line 

COPY TEXT, #CP 



will copy the file TEXT. SA from drive zero to the console 
punch (record) device. The punch device must be ready to 
receive data before the command line is entered. Since no 



"N" option was specified, an FDR record will be written 
before any data records are copied. 

Most frequently, however, the user will copy object 

files to the console punch for loading via the EXbug LOAD 

command. In such cases, the FDR should not be written to the 

punch device. Then, the following command line should be 
used: 

COPY TESTPROG. LX, #CPi N 

where TESTPROG. LX is the output file from an assembly process 
(in the EXbug-loadable format). The "N" option suppresses 
the writing of the FDR. If the TESTPROG. LX file had a 
non-ASCII file format, then an error message would have been 
displayed. 

The next example illustrates how source listings that 
have been directed to diskette by the assembler (RASM) can be 
printed on the line printer. Since the file already contains 
page formatting, the LIST command would cause the printed 
copy to look strange since LIST imposes its own page 
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formatting. Thus, the COPY command should b( 
source listings from diskette: 

COPY TESTPROG. ALi «LP 



used to print 



The console printer* #CN, could be 
as well. The "N" option is not used 
the printer (gither #LP or #CN) 
Copying to a "non-file" device will 
non-file format mode. If the "N" 
such a case* no error, would result, 
redundant req.uest. 



used instead of #LP just 
in this example because 

is not s "file" device. 

automatically set the 

option were specified in 

It would only be a 



The last example illustrates how the command line would 
appear if a user— defined device driver is used: 

COPY TESTPROG. LX/ #UD; ND=TAPE 



The user device is indicated via the 
must be present. Otherwise.- an error 
TAPE. LO on drive zero will be used as 
for the user device. 

7.5.3 Device-to-diskette example 



#UD. The "D" option 
would result. The file 
the device driver file 



Once a file has been copied to the console punch with an 
FDR. it can be verified or copieti back to diskette without 
having to specify its name. The following command line: 

COPY #CR 



will cause COPY to search for the first 

reader device. Once it is found, the file 

the FDR will be used for <naffle 2>. If the 

exist in the directory, it will be created 

the data records from the console reader 

already exists in the directory, a message 

by the COPY command asking the operator if the file should be 

overwritten. 



FDR on the console 
name contained in 
file name does not 
before receiving 
If the file name 
will be displayed 



The command line 



COPY #CR. TESTPROG. LX; VL 

on the other hand, will search the console reader device for 

an FDR that contains the file name TESTPROG. LX. The same 
file name must also exist in the directory of the diskette in 

drive zero so that the verification can take place. Any 

mis-comparisons between the two files will be printed on the 
line printer. 



If the user has files in a format that 
the console reader device, but which have no 



can be read by 
FDR, the "N" 
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option must be used to copy those -files to diskette: 

COPY #CR,FILE1jN 

In this example* the file indicated by <naffle 2> will receive 
the data from the console readsr. No search is performed for 
an FDR. If the file is on paper tape, then it must be in a 
format that is compatible with the MDOS ASCII records 
(section 24.3). That is* a carriage return^ line i^es6, null 
sequence must terminate each record. Otherwise, one or two 
data characters from the subsequent records may be lost. 
This results from the fact that the detection of a carriage 
return forces the device driver to turn off the reader. In 
the amount of time it takes to turn the reader off. one or 
tmo frames (characters) may have passed by the read head. 

The following example illustrates how a user would set 
breakpoints in his device driver to verify that it is 
performing the functions of a driver as specified in section 
26.2. The example shows EXbug 1 as the debug monitor: 

=COPY #UD. TEST; NMD=DRIVER 

BKPT ERROR 

P-2i26 X-2161 A-OD B-SO C-CO S-226F 

»3056i V 

«3064i V 

#3082; V 

*jp 

The EXbug monitor is given control after the user's driver 
file. DRIVER. LO; 0. has been loaded into memory by the COPY 
command. The user then sets three breakpoints (the addresses 
for the breakpoints are. of course. meaningless in this 
example — they serve only to illustrate that breakpoints are 
set). The ";P" command then returns control to the COPY 
command. When one of the breakpoints is reached during the 
execution of the COPY command, the normal breakpoint display 
will be seen. At that point, the user can examine registers, 
memory. etc. . to ensure that his driver is functioning 
properly. 

7.6 COPY with EXORtape Reader 



The COPY command will provide users with EXORtape paper 
taps readers an additional device type. Users with paper 
tape readers that are similar to the EXORtape can also use 
the COPY command without the requirement of a usei — defined 
device driver. 

The EXORtape reader interfaces through a PIA on the 

EXORdisk I interface module. The following steps must be 

followed to permit the EXORdisk I Interface Module to be 
accessed by the COPY command. 
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1. No boards may reside in the EXORciser that 
respond to addresses at locations $E000-E7FF, 
inclusive. 

2. The M63IFC'5 bass address must be changed via 
the five-position microswitch so that: 

S5 is closed^ 

S4 is closed. 

S3 is closedi 

S2 is open. 

Si is open. 

3. The M68IFC must be inserted into the 
EXORciser 's card cage with power of-f on the 

.i_^*^«. ^ tt S ^ ^ A^ 

4. The EXORtape should then be connected via its 
cable to P3 of the Interface Module. The 
COPY command can now use the EXORtape reader 
as an input device through the device name 

#HR 

in all instances that an input device is 
va 1 i d . 

For users without the M6SIFC but with a compatible paper 
tape reader (see "M6aR6aO EXORtape User's Guide"), a standard 
PIA interface can be used if the PIA is configured to the 
address «E404. 
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S. DEL COMMAND 



The DEL command is used to remove MDOS file names from a 
directory and to deallocate all space that belongs to the 
deleted entry. A single file name* a list of file names* or 
a family of file names may be deleted with a single command. 

8. 1 Use 



The DEL command is invoked uiith the following command 



line: 



DEL C<name 1> C>.....<name n>33 Cj<options>3 



ujhere each Cname i> < i = 1 to n) can specify a specific file 
name or a family of file names. The <Dptions> field can be 
one or both of the folloufing option letters: 

Option Function 



S When family name specifications are used 
include entries in the directory tuith the 
"system" attribute. 

Y Automatically delete all file names of a 
family. Do not ask the operator if each 
member of the family should be deleted. 

The list of file names specified on the command line is 
processed from left to right. As the list is processed, the 
file names are searched for in the directory specified by the 
logical unit numbers. If no logical unit number is 
explicitly entered by the operator, zero will be supplied as 
a default. No default suffix is supplied. 



File names which are 
command may be restored 
directory or the allocati 
deletion. The REPAIR 
contains an example of th 
restore such file name 
files be configured with 
backup copies be kept 
names in this manner; esp 
only work if the error is 
name is deleted. 



deleted by accident via the DEL 
if no other commands that affect the 
on table have been run after the 

command description (Chapter 22) 
e procedure that must 
s. It is recommended, 
delete protection or 

as an alternative to 
ecially since this restoration will 

detected immediately after the file 



be followed to 

however, that 

that adequate 

restoring file 
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8. 1. 1 Single -file name deletion 

A single file name is deleted by specifying its name as 
the only parameter en the comjnand line. Both the file's name 
and suffix must be supplied by the operator. If the file 
name is not found in directory of the indicated (or default) 
drive* the message 

<name> DOES NOT EXIST 

ujill be displayed. If the file name is found in the 
directory and if the file is unprotectedi the message 

<name> DELETED 

will be displayed to verify that the file name has been 
deleted. If the file is protected, the message 

<name> IS PROTECTED 

will be shown. In this case, the file name is not deleted. 

S. 1. 2 Multiple file name deletion 



Multiple file names can be deleted by specifying more 
than one name on the command line. Multiple file names must 
be separated by commas or some other valid delimiter. Like 
single file name deletion, multiple file name deletion will 
cause one message to be displayed for each file name entered 
on the command line to indicate whether it was deleted, 
whether it did not exist, or whether it was protected and 
could not be deleted. As many file names as can 
accommodated on the command line can be deleted at one time 

a. 1. 3 Family deletion 



be 



In either the single or the multiple file name modes, a 
file name specification can contain the family indicator. 
The family of file names specified by such a designation will 
then be considered for deletion. Unlike the single and 
multiple file name modes, the operator will be prompted with 
the message 

DELETE <name> ? 

for each file name that belongs to the family. This permits 
the operator to see all family members before they are 
deleted. A "Y" response to the above prompt will cause the 
file name to be deleted. Any other response will inhibit 
deletion of that family member. Protected file names withm 
the family will be displayed with the standard protection 
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message indicating that they cannot be deleted. 

Without the presence of ang options* only file names. 
lacking the "systeni" attribute will be considered as eligible 
for deletion in the family mode. 

A special case of the family mode is the absence of any 
file name specification. In this case# the DEL command 
processes the command line as if the folioiying file name 
specification had been given 

*. *: O 



which will make all non-system 
eligible for deletion. 



file names 



on 



drive zero 



A l0"ical unit number may be entered on the command line 
as the only part of the file name specification. In this 
case, the family *. » mill be eligible for deletion. Instead 
of the default drive, however, the operator entered logical 
unit number will be used. 

a. 2 Options 



The "S" option is used to include file names with the 
system attribute in the family mode of deletion. Normally, 
the family mode excludes such file names. The "S" option has 
no effect in the single or multiple file name modes. 

The "Y" option will inhibit the DEL command's prompt 
asking if each family member is be deleted. The effect of 
specifying the "Y" option is to give an automatic "Y" 
response to the prompt; however, neither the prompt nor the 
automatic response avs displayed. The deletion messages 
indicating which members of the family were deleted or 
protected will still be shown. 

The "Y" and "S" options can be used concurrently. 



8. 3 Messages 



The following messages can be displayed by the DEL 
command. Not all messages are error messages; however, error 
messages srs included in the list. The standard error 
messages that can be displayed fag all commands are not shown 
here. 



<n3me> DOES NOT EXIST 



This message is displayed for each file name on 
the command line that is not found in a 
directory. 
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<name> DELETED 



This message is displayed for each file name that 
is deleted. It is displayed in single* multiple* 
or family file name modes. 



DELETE <naffle> ? 



This prompt is displayed whenever a family of 
file names containing at least one member has 
been specified on the command line, and the "Y" 
option is not present. The operator must respond 
uiith a "Y" to delete each member of the family. 



<name> IS PROTECTED 



This message is displayed for each file name that 
cannot be deleted due to its protection 
attributes. The message is displayed in single.- 
multiple, or family file name modes. 

8. 4 Examples 

To delete a single file name called TESTPROG. SA on drive 
zero, the following command line would fas' entered: 

■ DEL TESTPROG. SA 

The DEL command would then display the message 

TESTPROG. SA: DELETED 

after it has deleted the file name. To delete the three file 
names: SCRATCH. SA on drive one. TEST. LX on drive two. and 
PROG. RO on drive zero, the following command line would be 
used. The system's responses are also shown: 

=DEL SCRATCH. SA: 1. TEST. LX: 2. PROG. RO 
SCRATCH . SA; 1 DELETED 
TEST . LX : 2 DELETED 
PROG . R0:0 DELETED 

The following command line 

DEL *. SA, *. SA: 1 

will search for all file names without the system attribute 
and with the suffix "SA" on drives zero and one. After a 
file name is found, its complete name will be displayed along 
with the prompt asking if the file is to be deleted. The 
operator has complete control over the delet.ion of any member 
of the family since a response is required for every member. 
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To deists all unprotected file names on drive three 
without having to respond "Y" to each prompt, the following 
command line could be used: 

DEL : 3; YS or DEL ». *: 3; YS 

In this case* unprotected file names with and without the 
system attribute will be deleted. 
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The DIR command displays MDQS file names -Prom the 
directory. The entire direct43ry or selective parts of it may 
be displayed. Options exist for displaying an entire 
directory entry* its allocation information. and for 
directing the output to the printer. 

9. 1 Use 

Tha nti? rnmmand is invoked with the follouiing cosrjnsand 



1 ine: 



DIR C<name>1 Ci<aptions>3 



where <name> can specify a specific file name or a family of 
file names. The <options> field can be one or more of the 
following option letters: 

Option Function 

L Direct output to line printer. 

S include file names ' ujith the "system" 
attribute when displaying a family. 

E Display the entire directory entry for each 
file name. 

A Display the associated allocation information 
along with the entire directory entry. 

Whenever the DIR command is invoked- regardless of 
options or file name specif ications» the drive number and the 
ID from the diskette in the specified or default drive will 
be displayed as a heading. This heading will serve to 
identify the subsequent output. The heading has the 
following format: 

DRIVE : i DISK I. D. xxxxxxxx 

where "i" will be the logical unit number zero# one* two. or 
three, and "xxxxxxxx" will be the eight-character ID that was 
assigned to the diskette via the DOSGEN command (Chapter 10) 
or the BACKUP command (Chapter 3). 

Normally/ without the presence of any options, the 
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directory entry specified by <name> will be searched for and ^^ 

its name and suffix displayed on the system console. The 

folloiiiing sections explain the various options that can be 

specified on the command line. 

9. 1. 1 Families 

If <name> contains a family indicator in either the 
suffix or the file name portion of the file name 
specification, the entire family of file names uill be 
searched for in the directory and displayed. If no <name> is 
specified at all, the default family "*. *: 0" will be "sed.^ 
If only a logical unit number is specified, the family "». *" 
on the indicated logical unit uiill be used. If the "S" 

option has noi: oeen speciriea, uuxy .**= ..=...»» -- .. --- 

"system" attribute mill be included in the display. This 
eliminates the display of all MDOS system files and commands. 

When <name> contains a family indicator (explicitly or 
by default), the file names ars displayed in the order in 
which they are found in the directory. A file name's 
position in the directory is a function of its name and 
suffix. Appendix G describes in more detail how names sr^ 
placed into the directory; however, it should be noted here 
that when a file's name or suffix is changed, its position in 
the directory may also change. Thus, when the directory is 
shown at different times, the order of the displayed names 
may differ. 

9. 1. 2 System files 



File names with the "system" attribute will be included 
in the output of the DIR command if the "S" option is 
specified on the command line. If a specific file name is 
being searched for (<naffle> does not contain the family 
indicator), then the "S" option has no effect. 

The effect of the "S" option is identical to its effect 
with the DEL command (Chapter S). Thus, the same family of 
file names displayed by the DIR command will be affected by 
the DEL command (if invoked with similar command line 
parameters). This feature allows an operator to see ahead of 
time what family of file names will be affected by the DEL 
command. 

9.1.3 Entire directory entry 



Normally, DIR will only display a file's name and 
suffix. The "E" option can be used to cause the s"*^_^® 
directory entry to be displayed. The presence of the "E" 
option will cause each displayed line from the DIR command to 
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look like: 

FFFFFFFF. SS WDSCN# RRRR ZZZZ DD 
where the symbols take on the following meanings; 
Symbol Meaning 



FFFFFFFF 


File name 


SS 


Suffix 


WDSCN# 


Attributes 


RRRR 


RIB address 


ZZZZ 


File size 


DD 


Directory entry number 



The file name and suffix arsi of course, obvious. The file 
attributes are always displayed as a sis-charaeter field. 
The presence of a letter or number in a specific position of 
the attribute field indicates that the particular attribute 
applies to the file. A period in a position of the attribute 
field indicates that the particular attribute does not apply. 
The following letters (and positions) are defined in the 
attribute field: 

W D S C N # 

File format <0=user defined* 
2=mefflory -image; 
3=binary record, 
5=ASCII record, 
7=ASCII-converted- 
binary record) 
Non-compressed spaces 
Contiguous space allocation 
System file 
Delete protection 
Write protection 

Thus, if the "W" is displayed, the file is write protected. 
If no "W" is displayed, the file is not write protected; if 
the "C" is displayed, the file is allocated contiguous space; 
if no "C" is displayed, the file is segmented; etc. 

The remainder of the fields of the directory entry 
contain only hexadecimal numbers. The RRRR field contains 
the physical sector number of the first sector of the file. 
This sector is known as the file's Retrieval Information 
Block (RIB). It is described in detail in Chapter 24. The 
RIB contains the allocation information that describes where 
the remainder of the file is located on diskette. 

The ZZZZ field contains the file's size in sectors. Due 
to the allocation scheme used by MDOS, this field will always 
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be a multiple of the basic unit of allocation (see Chapter 
24) The size is, therefore, the physical size of the file. 
The' logical file size, or the number of sectors from the 
beginning to the end-of-file indicator, (nay be smaller. 

The DD field is an eight-bit coded field that describes 
the directory entry's physical position within the directory. 
It is interpreted as fallows: 



Position uiithin sector 
(0-7) 

Physical sector number 



9.1.4 Segment descriptors 



If the "A" option is specified on the command line, then 
in addition to having the entire directory entry displayed 
for each file name, the file's allocation information luill 
also be shown. The allocation information is contained in 
the file's RIB and describes where each segment of the -file 
is located on the diskette. This information is displayed 
following the complete directory entry. One line is shown 
^-« »=^h »«r,ment of the file. The format of the allocation 



for each segment of the file 
information is 

ss pppp zzz 

where "ss" is the number of the segment (0-56, decimal), 
"pppp" is the physical sector number of the sector that 
starts the segment (hexadecimal), and "zzz" is the size of 
the segment in sectors (hexadecimal). For example, a 
directory entry could appear as follows: 

FDRLB RO . DS. . 3 04?0 0088 75 00 0490 080 

01 0510 008 

The file FDRLB RO consists of two segments. The first 
segment starts in physical sector «490 and is $80 sectors 
long The second segment starts in physical sector *5i0 and 
is 8 sectors long. The file's physical size is $88 sectors. 

9. 1. 5 Other options 

Normally, the output from the DIR command is displayed 
on the system console. The "L" option can be used to direct 
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the output to the line printer. The format of the display is 
the same. Like other MDOS commands that direct output to the 
line printer, the paging will be preserved by the DIR 
command. Thus, once the paper in the printer has been 
aligned* it will remain aligned after a directory has been 
printed. 

9. 2 Messages 

The following messages can be displayed by the DIR 
command. The standard error messages that can be displayed 
by all commands are not listed here. 

DRIVE : i DISK I. D. xxxxxxxx 

This is the directory command's heading line that 
is displayed each time the command is invoked, 
"i" is the logical unit number. "xxxxxxxx" is 
the diskette's ID that mas assigned to it when it 
mas generated. 

TOTAL NUMBER OF SECTORS : dddd/«hhh 

This message is displayed if either the "E" or 
the "A" option u>as specified on the command line. 
and if one or more directory entries were found. 
It gives the total number of sectors that is 
allocated to the files whose names are displayed, 
"dddd" is the decimal value of the total. "hhh" 
is the hexadecimal value of the total. This 
message is displayed after all file names have 
been printed. 

TOTAL DIRECTORY ENTRIES SHOWN ddd/«hh 

This message is shown at the end of each 
directory search that found at least one file 
name. It gives the total number of directory 
entries included in the display. "ddd" gives the 
decimal value of the total. "hh" gives the 
hexadecimal value of the total. 

NO DIRECTORY ENTRY FOUND 

This message is displayed if the <name> specified 

on the command line does not result in any 

matches with directory entries on the diskette. 

If <name> contains a family indicator. the 

message means that no members of that family were 
found on the diskette. 
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»N0 SDW'S* \ 

This message ujill only bs displayed if the "A" 
option is in effect and if an invalid RIB is 
found for a file. The message is displayed in 
place of the segment descriptor information that 
appears to the right of the entire directory 
entry. Whsn such a snessage is seen- it indicates 
that the file has probably been damaged. Since 
no segment descriptors are found in the RIB. the 
file will not be accessible any longer. The 
REPAIR command (Chapter 22) should be used to 
check the remainder of the diskette, as well as 
to remove the erroneous file. 

NO TERMINATOR FOUND IN FILE'S R. I. B. 

This message can only be displayed if the "A" 
option luas specified on the command line. Like 
the previous message- this one indicates that a 
file's RIB has been damaged. It indicates that 
the terminator was missing from the RIB. The 
allocation information displayed for the file is 
meaningless since 56 segment descriptors have 
been displayed. The file's content is no longer 
accessible. The REPAIR command <Chapter 22) 
should be used to check the remainder of the 
diskette? as uiell as to remove the erroneous 
file. 

9. 3 Examples 

When the DIR command is invoked without any options on a 
newly received system diskette, this is luhat uiill be seen on 
the system console: 

=DIR 

DRIVE : DISK I. D. : MD0S0300 

NO DIRECTORY ENTRY FOUND 

A new system diskette has only file names with the "system" 
attribute. Those file names will be excluded from the 
directory search unless the "S" option is specified. Thus, 
the default family *. »: O (since no <name> was specified) 
contains no members. Using the "S" option on the above 
example would result in the following display: 
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COMMAND 


=DIR ;S 








DRIVE : 


DISK I. D 


: MDOS0300 




BINEX 


.CM 






LIST 


.CM 






MDOSOVO 


. SY 






DIR 


-CM 






MERGE 


.CM 






MDOS0V4 


. SY 






MDOS 


. SY 






MD0S0V6 


. SY 






FREE 


. CM 






EQU 


. SA 






ROLLOUT 


. CM 






DUMP 


.CM 






EXBIN 


. CM 






NAME 


. CM 






MDOSQVl 


. SY 






PATCH 


. CM 






BLOKEDIT 


•. CM 






LOAD 


. CM 






MD0SOV3 


. SY 






KDOSbK 


. SY 






DEL 


.CM 






ECHO 


. CM 






CHAIN 


. CM 






BAqKUP 


. CM 






REPAIR 


. CM 






MD0S0V5 


. SY 






DOSCEN 


. CM 




' 


B1C0PY 


. CM 






COPY 


. CM 






FORMAT 


. CM 





9. 3 — Examp les 



TOTAL NUMBER OF ENTRIES SHOWN : 030/$ IE 



No -File attributes or file sizes are displayed sines neither 
the "E" nor the "A" option was specified. 

If a diskette is in drive one which contains 
MDOS-Supported software products (see Appendix H). the 
following shows houi the directory entries with suffix "CM" on 
that drive can be displayed: 



=DIR *. CM: 1; AS 

DRIVE : 1 DISK I. D. : EDIT0300 
ASM . CM . DSC. 2 OOBO 002C 70 
EDIT . CM . DSC. 2 0230 OOIS 72 



OO OOBO 02C 
00 0230 OlS 



TOTAL NUMBER OF SECTORS : 006B/»044 
TOTAL DIRECTORY ENTRIES SHOWN : 002/«O2 



Both the EDIT and ASM commands reside on drive one. From 
their attributes it can be seen that those files are not 
write protected, are delete protected* are system files, are 
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contigously allocated on diskette, and are of file format 2 > 
(memoTy-image). The ASM cofflmand is located starting at 
physical sector $B0 and is $2C sectors long. The EDIT 
comiwand is located starting at sector *230 and is *1S sectors 
long. Both files have only one segment descriptor. The ASM 
command's file name is the first directory entry in physical 
sector *E <found by shifting its directory entry number to 
the right three bit positions). The EDIT command's directory 
entry is in the same sector/ but is the third entry in that 
sector. 

In all of the above examples, the "L" option could have 
been used in addition to any other options to direct the 
output from the DIR command to the line printer. 



J. V 



is recommended that a copy of the directory printout 
containing the entire directory entry and the allocation 
information be kept with each diskette. Since files can 
dynamically expand and contract, their location on diskette 
may change. If something happens to the diskette to damage 
the directory, there is no way to recover any information 
from it if a prior printout has not been saved. Normally, 
the printout will never be needed, but as a precaution it is 
indispensable. 



.y 
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10. DOSGEN COMMAND 

The DOSGEN command allows specialized MDOS diskettes to 
be QTepar-sd. Diskettes that ha-^e bad sectors can have those 
sectors locked out so that the diskette can be used in an 
MDOS environment. DOSGEN will also create all system tables 
and files on the generated diskette. The DOSGEN command can 
be used to generate system diskettes on either single-sided 
or appropriately formatted double-sided diskettes. 

10. 1 Use 



NeuJ single-sided diskettes, or single-sided diskettes 
never before used on an MDOS system/ must first be prepared 
for use uiith MDOS. One way to generate a neu! MDOS diskette 
is by invoking the BACKUP command (Chapter 3); however, the 
BACKUP command does not perform the write/read test that can 
be invoked via DOSGEN; nor is there the guarantee that all 
system files ars copied to the destination diskette since the 
operator can selectively prevent files from being copied. 
Another way to generate a new MDOS diskette is by invoking 
the DOSGEN command from an already up-and-running MDOS 
system. 

DOSGEN- does not create the sector addressing 
information. Single-sided diskettes usually come 
ppe_f o^tnatted in an IBM-3740-simi lar format with the 
established sector addressing information. Double-sided 
diskettes- however* must be formatted with the FORMAT command 
(Chapter 15). since the double-sided format required by an 
EXORdisk III is a non-standard single-density format. In 
either casei whether single- or doub 1 e-sided» other 
information must be written on a new diskette in order to 
make it recognizable by MDOS. DOSGEN creates the system 
tables required by MDOS (see Chapter 24). These tables 
include a skeleton directory/ a bit map showing which sectors 
of the diskette are available for space allocation; a lockout 
map showing which sectors of the diskette are bad or locked 
out by the user; and an identification sector containing a 
name to identify the diskette; the generation date/ and the 
MDOS version number. The DOSGEN command also copies across 
the required MDOS family of system files which must be 
present on any diskette used in the MDOS environment. These 
files and tables must not be moved or changed in any way 
other than through the DOSGEN command and two other commands: 
BACKUP (Chapter 3) and REPAIR (Chapter 22). Optionally. the 
MDOS commands may be copied to the diskette. 
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10. 1 — Use 



line: 



The D0S6EN comtnand is invoked with the -following command 



DOSSEN C:<unit>3 Ci<options>3 



where <unit> is the logical unit number (1-3) of the drive 
containing the diskette to be DOSGENed, and <options> can be 

Option Function 



Perform write/read test. 



U 



Generate minimom system (user diskette). 



If <unit> is not specified, logical unit one will be 
used as a default. Logical unit zero cannot be DOSGENed. 

The diskette to be DOSGENed must be placed in the 
logical unit specified on the command line (logical unit one. 
if no <unit> mas specified). DOSGEN will respond with the 
following question asking if <unit> contains a diskette that 
can be written to: 

DOSGEN DRIVE <unit> ? 

The response should be the letter "Y". if the diskette in the 
indicated <unit> is to be DOSGENed. Any other response will 
terminate the DOSGEN command and return control to fIDOS. In 
this case, the diskette in <unit> is not affected. 

If a "Y" is given as a response, certain information .for 
the diskette's identification sector must be supplied by the 
operator. This information is entered in response to the 
following DOSGEN prompts: 



Prompt 



Operator Input 



DISK NAME: 



An alphanumeric name, a maximum of S 
characters in length. which will 
appear on subsequent heading lines 
from the DIR and FRiEE commands. The 
name must begin with an alphabetic 
character. 



DATE (MMDDYY) 



The date of generation in six-digit, 
numeric form as indicated by the 
parenthetical inset. 



USER NAME: 



A maximum of twenty 
characters used for 
information only. 



disp layable 
descriptive 
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The version and revision numbers of MDOS will be 
automatically supplied by the DOSGEN command. 

The operator is then given a chance to lock out an area 
of the diskette. This area will not be accessed by any MDOS 
command or function since it is an allocated block without a 
RIB. This permits the operator to set aside a part of the 
diskette for his own use. All MDOS information must be in 
files in. order to b# accessed by MDOS. The message 

LOCKOUT ADDITIONAL SECTORS? 

is displayed to allow sector lockout. An "N" response will 
cause DOSGEN to continue with the next step; no sectors will 
be locked out* leaving as much diskette space as possible for 
conventional file use. A "Y" response will cause the 
following messages to be shown: 

ENTER STARTING SECTOR (HHH): 
ENTER ENDING SECTOR (HHH): 

The operator can respond with only a carriage return* which 
will casus the lockout request to be bypassed. Otherwise* 
the response must be a valid hexadecimal sector number for 
each prompt. The sector numbers entered must meet the 
following criteria in order to cause the specified diskette 
area to be locked out: 

1. The sector numbers must be hexadecimal. 

2. The starting sector number must be the 
physical sector number of the first cluster 
to be locked out. The ending sector number 
must be the physical sector number of the 
last cluster to be locked out. 

3. The starting sector number must be less than 
or equal to the ending sector number. If the 
two numbers are equal* only one cluster will 
be locked out. 

4. Both sector numbers must be greater than *1S 
and less than »7D0 if generating a 
single-sided diskette, or greater than *18 
and less than «FA4 if generating a 
double-sided diskette. In either case. the 
locked out area should be located such that 
the largest block of free space resides in 
sectors with numbers less than that of the 
start of the locked out area. 

DOSGEN will then write the ID sector, an initialized 
allocation table* a lockout table, an empty directory, and a 
Bootblock to the destination diskette. Normally. DOSGEN will 
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then copy all files that have the "system" attribute from the 
diskette in drive zero to the destination diskette. When 
DQSSEN is finished. a complete fIDOS system will have been 
generated on the destination diskette. 

10.2 Diskette Surface Test 



If DOSGEN is invoked with the "T" option/ a write/read 
test will be performed to ensure that the sectors on the 
destination drive are good. Any sectors which fail the 
write/read test will be flagged with the deleted data mark. 
If sectors cannot be flagged in this manner/ the diskette 
cannot be generated. Such diskettes may be made usable again 
by using the FORMAT command (Chapter 15). If a sector can be 
sjiSTked as bad.- then the cluster to which the bad sector 
belongs will be automatically locked out from MDOS usage. 
This individual cluster lockout is independent of the area of 
diskette that can be locked out by the operator. It will 
allow diskettes with bad spots to be generated and made 
usable as MDOS system diskettes. 

Diskettes that have such bad sectors can be used as 
normal diskettes with the following exception. The BACKUP 
command should not be invoked without a Main Option (unless 
the "D" option is used) to make a complete copy of the 
allocated space. Without the "D" option, the complete copy 
process will abort if a fatal read error occurs. Since the 
complete copy is based on the allocation table, it is 
inevitable that the bad sectors locked out via DOSGEN will be 
read. Thus, the resultant copy of the diskette will always 
be incomplete. Therefore. BACKUP should always be run with 
the "R" option to force file reorganization. In this manner, 
the bad sectors will never be read since they ars not a part 
of any allocated file. 

Diskettes which have had had sectors locked out should 
not be used as the destination diskette with BACKUP. 

If sectors get locked out into which the MDOS system 
files normally are copied (in the first several cylinders) 
the DOSGEN process will fail. Such diskettes cannot be used 
as MDOS system diskettes unless the FORMAT command (Chapter 
15) can be used to correctly rewrite the bad sectors. 

10.3 Minimum System Generation 

If the DOSGEN command is invoked with the "U" option, 
the resultant diskette will not contain any of the MDOS 
commands from drive zero. Only the MODS family of system 
files that must reside on every diskette used in an MDOS 
environment will be copied. The "U" option is useful in 
generating user diskettes which ars to contain only data 
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files and will almost always be used in drives other than 
zero. 

10. 4 Messages 



The following messages can be displayed by the DOSGEN 
command. Not all messages are error messagesi although error 
messagss ars included in the list. The standard error 
messages that can be displayed by all commands are not listed 
here. 

DOSGEN DRIVE <unit> ? 

This message permits the operator to exit the 
DOSGEN command or allows him time to insert a 
scratch diskette before continuing. A "Y" 
response will cause DOSGEN to continue. Any 
other response will cause control to be returned 



to MDOS. 



DISK NAME; 



This prompt is used to obtain the eight character 
ID field that is subsequently displayed by all 
DIR and FREE commands when used on the generated 
diskette. The ID field has the same format as an 



MDOS file name. 
DATE (MMDDYY): 



USER NAME: 



This prompt is used to obtain the date of 
diskette generation. The date must be six 
numeric characters. 



This prompt is used to obtain the descriptive 
information for the ID sector. Up to twenty 
displayable characters may be entered. 



LOCKOUT ADDITIONAL SECTORS? 



This message allows the user to specify whether 
or not he wishes to reserve a block of the 
diskette for his own use. The block will be 
excluded from use by MDOS. A "Y" response will 
cause the next two prompts to be issued. Any 
other response will cause the lockout request to 
be bypassed. 
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ENTER STARTING SECTOR (HHH): ~^^ 

t 

This prompt is used to obtain the starting 
hexadecimal sector number of the first cluster 
that is to be locked out. 

ENTER ENDING SECTOR <HHH): 

This prompt is used to obtain the starting 
hexadecimal sector number of the last cluster 
that is to be locked out. 

ABOVE SECTORS HAVE BEEN LOCKED OUT 

This message will be displayed if valid starting 
and ending sector numbers have been specified for 
the sT^a to be locked out. 

INVALID SECTOR NUMBER 

This message is displayed if either the starting 
or ending sector number does not meet the 
criteria set forth in section 10. 1. The operator 
is given another chance to enter the sector 
number range. 

SECTOR nnnn LOCKED OUT 

When a bad sector is detected during the 
write/read test <"T" option). this message is 
displayed to indicate uihich sector failed the 
test. The "nnnn" is the hexadecimal, physical 
sector number. The cluster in which the sector 
resides will be automatically locked out. 

COPYING FILE <name> 

This message is displayed for each system file as 
it is being copied to the destination diskette. 
It serves only to monitor the DOSGEN operation. 

MDOS. SY DOES NOT START AT SECTOR «1S 

This message indicates that the destination 
diskette cannot be generated. Either the 
operator or the write/read test locked out 
sectors which prevented the resident operating 
system file MDOS. SY from residing at the 
specified physical location. If the operator 
locked out those sectors, the diskette should be 
regenerated with a different range locked out. 
If the write/read test locked out those sectors, 
the diskette is unusable as a system diskette. 
Chapter 15 should be consulted for making such a 
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diskette usable again. 
10. 5 Examp les 



The following example shows 
interaction during a DOSGEN process: 



the operator-system 



DOSGEN DRIVE 1? Y 
DISK NAME: USEROOOl 
DATE (MMDDYY): 072578 
USER NAME: SYSTEM DEVELOPMENT 
LOCKOUT ADDITIONAL SECTORS? N 
COPYING FILE MDOS . SY 
COPYING FILE MDOSOVO . SY 
COPYING FILE MDOSOVl . SY 
COPYING FILE MD0SQV2 . SY 
COPYING FILE MDOSOVO . SY 
COPYING FILE MD0S0V4 . SY 
COPYING FILE MD0S0V5 . SY 
COPYING FILE MD0S0V6 . SY 
COPYING FILE MDOSER . SY 



The diskette to be generated was tested with the u/rite/read 
test C"T" option) to ensure that all sectors were good. A 
minimum system \iiss generated ("U" option). The neui ID/ 
USEROOOl. the generation date, July 25, 1978, and the 
descriptive information, SYSTEM DEVELOPMENT 1, were placed 
into the ID sector. Since no additional sectors were locked 
out, DOSGEN proceeded to copy the MDOS family of system files 
that must reside on each diskette. 

The following example shows what might happen if a bad 
diskette is used in the generation process: 

=DOSGEN : 2; T 

DOSGEN DRIVE 2? Y 

DISK NAME: USER0002 

DATE (MMDDYY): 072578 

USER NAME: TEST SYSTEM 

SECTOR 0030 LOCKED OUT 

SECTOR 0031 LOCKED OUT 

SECTOR 0056 LOCKET OUT 

LOCKOUT ADDITIONAL SECTORS? N 

COPYING FILE MDOS . SY 

MDOS. SY DOES NOT START AT SECTOR *1S 



Three bad sectors were found during the write/read test. 
When the MDOS family of files was copied, it was detected 
that the locked out sectors prevented the resident operating 
system file MDOS. SY from residing at the specified physical 
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location. If the operator locked out those sectors, the 
diskette should be regenerated with a different range locked 
out. If the uirite/read test locked out those sectorsi the 
diskette is unusable as a system diskette. Chapter 15 should 
be consulted for making such a diskette usable again. 
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11. DUMP COMMAND 



The DUMP command allows the user to examine the entire 
contents of any physical sector on the diskette. The sector 
can be displayed on either the system console or the printer. 
The display contains both the hexadecimal and the ASCII 
equivalent of every byte in the sector. The DUMP command 
alloms the opening of files so that they can be examined 
using logical sector numbers. Sectors can also be moved into 
a temporary buffer where changes can be applied before they 
are written back to diskette. 



11. 1 Use 



1 ine: 



The DUMP command is invoked with the following command 



DUMP C<name>: 



where the presence of the optional file name determines the 
initial mode of operation. The DUMP command is an 
interactive program that has its own command structure. Once 
DUMP is running, it will display a colon <: ) as an input 
prompt whenever it is ready to accept a command from the 
operator. Commands exist for selecting logical units. for 
opening and closing files. for displaying sectors. for 
modifying single sectors, and for displaying the directory 
and cluster allocation table. 

11. 1. 1 Physical Mode of operation 



If no <name> is specified on the command line, or if 
<name> only consists of a logical unit number, then DUMP will 
be in the "Physical Mode" when it displays its input prompt. 
The heading 

PHYSICAL MODE 

will be displayed prior to the prompt the first time that 
DUMP is activated. From that point on. it is the operator's 
task to keep track of which mode of operation DUMP is in. 
The Physical Mode of operation means that all subsequent 
commands referring to sector numbers will be interpreted as 
physical sector numbers. The Physical Mode of operation 
remains active as long as no files are opened. 

If no <name> is specified on the command line. DUMP will 
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ds-Pault to logical unit zero for all subsequent commands. -^ 
The unit will remain selected until another unit selection J 
command is issued by the operator. To override the default 
unit selected, the operator can specify only a logical unit 
number on the command line in place of <na(ne>. In this case, 
the initial unit selected will be the logical unit number 
entered on the command line (0-3). The logical unit number 
_..-j. t- ----.a-j = ^ hn 3 rninn. the loflical unit number 

delimiter. 

When a logical unit number is specified on the command 

line, the diskette to be inspected with DUMP should already 

be in the indicated drive. If no diskette is in the 
specified drive, the message 

**PRaM l/^ ER.R0R-STATUS=33 AT h DRIVE i-PSN j 

is displayed/ indicating that the drive is not ready. The 
"U" command (section 11.2.2) must be used to restore the 
diskette drive after the diskette has been inserted. 

11.1.2 Logical Mode of operation 

If a <name> which exists in the directory is specified 
on the command line, then DUMP will be in the "Logical Mode" 
of operation when it displays the input prompt. <name> must 
contain an explicit suffix. No default suffix is supplied by 
the DUMP command. The logical unit number, however, is given 
a default value of zero if it is not specified on the command 
line. 

If the <narae> cannot be found in the directory. a 
standard error message will be displayed indicating that the 
file name does not exist. In that case, the Physical Mode of 
operation will be entered; however, the physical mode message 
will not be displayed since the error message has already 
indicated that the file could not be opened. 

The Logical Mode of operation means that all subsequent 
references to sector numbers will be interpreted as logical 
sector numbers of the file <name.>. A special convention is 
used when referring to the RIB of a file. The logical sector 
number of the RIB is FFFF. Since logical sector number zero 
is the first data sector of the file, the RIB has a logical 
sector number of minus one (FFFF). DUMP will remain in the 
Logical Mode of operation until the file is closed or until 
another unit is selected. 

11.1.3 Sector change buffer 

Certain commands can reference a temporary sector buffer ; 
known as the "sector change buffer". This buffer is large 
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enough to accommodate one sector from diskette. The sector 
change buffer can be used in either mode of operation. The 
contents of the sector change buffer will not be destroyed or 
altered unless the operator issues a command to do so. 

Associated uiith the sector change buffer is a "sector 
address validity flag". This flag indicates whether or not a 
critical command has been executed between the time the 
sector change buffer uias read into and the time that the 
sector change buffer is written back to diskette. When the 
sector change buffer is read into, a sector address is 
specified. This address is retained so that if the sector is 
to be written back to diskette, the address need not be 
specified again; however, certain actions, described under 
the separate command descriptions that follow, can cause the 
sector address to be invalidated. Then, the writing of the 
sector change buffer requires a respec if ication of the 
sector address into which the buffer is to be written. 

The sector change buffer is very useful in modifying 
sectors. Most frequently, the sector change buffer is used 
in conjunction with the REPAIR command (Chapter 22) to fix 
critical system tables which have been found in error. Of 
course, this procedure is not recommended unless the operator 
has detailed knowledge of the system table structure. 
Situations do arise when critical file information can only 
be recovered through the manual "reconstruction of certain 
system tables. The DUMP command's sector change buffer 
provides the ideal means for doing this. 

11. 2 DUMP Command Set 



Each command to DUMP must be entered by the operator 
after the input prompt' (:) is displayed on the system 
console. Like all MDOS input, all DUMP commands must be 
terminated by a carriage return. In the following command 
descriptions these symbols are used: 

Symbol Meaning 



m, n 



Both "m" and "n" ai^e one to four digit 
hexadecimal numbers used for specifying a 
sector number or a cluster number. 

"i" is a one digit number used for 
referring to the logical unit number. 

"b" is a one or two digit hexadecimal 
number used as an offset into the sector 
change buffer. 
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a 
<str> 

11. 2. 1 Quit — Q 



"c" is a one or two digit hexadecimal 
nufflber. 

"a" is an ASCII character. 

"<str>" is a string of elements separated 
by commas. Each element can be a "c" or 

quotes. 

"<cr>" is a carriage return. 



1 



The 
control 
letter "Q". 
lost. The 
If a file is 
command. 



to terminate DUMP anc 



return 



Q cQiiHnand zs use; 

to MDOS. The format of the Q command is simply the 
Any information in the sector change buffer is 
Q command is valid in either mode of operation, 
open/ it is unaffected by the execution of the Q 



11.2.2 Select logical unit 



U 



The U command is used to select the logical unit number. 
The format of the U command is • 

U i 

where "i" can be any of the digits 0-3. The U command is 
valid in either mode of operation; however^ if the current 
mode of operation is the Logical Modej then the file that is 
open mill be automatically closed. After the U command is 
executed* the Physical Mode of operation will be in effect. 
The sector address associated mith the sector change buffer 
is invalidated by the U command. 

If DUMP was invoked uiith only a logical unit number on 
the command line, and if a diskette was not in the drive at 
the time DUMP was invoked, then the U command must be used to 
restore the diskette drive after a diskette has been inserted 
into the drive. If this procedure is not followed. timeout 
errors may occur on that drive since the head may not have 
been properly positioned to cylinder tsvQ. 

11.2.3 Open diskette file — 



the 
is 



The command is used to open a file and thereby enter 
Logical Mode of operation. The format of the command 

<name> 
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u,here <name> consists of at least a file name and a ^"^^i^. 
If no logical unit number is specified for <name^. the last 
logical unit selected via the U command mill be used as a 
default If 3 logical unit number is specified for <name>, 
then it will become the selected unit number even if the 
Physical Mode of operation is entered later. If a file is 
currently open, it mill be automatically closed uihen the 
command is executed. If the file <name> is not found, then 
the Phusical Mode of operation will be m ei-reci: avTiSr an 
error message is displayed. The sector address associated 
with the sector change buffer is invalidated by the 
command. 

11.2.4 Close diskette file — C 

T-u- Q command is used te close the file that is 

currently open" The format of the close command is simply 

the letter "C". If the current mode of operation is already 
the Phusical Mode, then no action results from the execution 
of the C command. If a file is open, then the Physical Mode 
of operation will be entered after the file is closed The 
sector address associated with the sector change buffer is 
invalidated by the C command. 

11,2.5 Show sector — S 



The S command is used to display a sector's contents on 
the system console. There are several forms of the S 
c ommand. 

Command Effect 



SB 



Display the contents of the sector change 
buffer. 

Display the contents of the Cluster 
Allocation Table. The SB command is only 
valid in the Physical Mode of operation. 



S mC,n3 Display the contents of sector "m" or the 
contents of sectors "m" through "n". The 
values of "m" and "n" are either physical 
or logical sector numbers depending on 
the current mode of operation. 

SD LmZ.ull Display the contents of the directory 
sectors. The entire directory will be 
displayed if no "m" and no "n" are given. 
Otherwise, the logical sector "m" or the 
logical sectors "m" through "n" of the 
directory will be displayed. The SD 
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command is only valid in the Physical "n, 
Mode of operation. 

SC mC,n3 Display the contents of cluster «m" or 
the contents of clusters "m" through "n". 
In this case, "m" and "n" are physical 
cluster numbers rather than physical 

valid in the Physical Mode of operation. 
Far each cluster/ four sectors will be 
displayed. 

The format of a displayed sector is shown in section 11.4. 
11.2.6 Print sector — L 



The L command is used to print a sector's contents on 
the line printer. There avs several forms of the L command. 

Command Effect 

L Print the contents of the sector change 

buffer. 

I_3 Print the contents of the Cluster 

Allocation Table. The LB command is only 
valid in the Physical Mode of operation. 

L mC#n: Print' the contents of sector "m" or the 
contents of sectors "m" through "n". The 
values of "m" and "n" are either physical 
or logical sector numbers depending on 
the current mode of operation. 

LD CmC/n33 Print the contents of the directory 
sectors. The entire directory will be 
printed if no "m" and no "n" are given. 
Otherwise, the logical sector "m" or the 
logical sectors "m" through "n" of the 
directory will be printed. The LD 
command is only valid in the Physical 
Mode of operation. 

LC mE.n3 Print the contents of cluster "m" or the 
contents of clusters "m" through "n". in 
this case. "ra" and "n" are physical 
cluster numbers rather than physical 
sector numbers. The LC command is only 
valid in the. Physical Mode of operation. 
For each cluster, four sectors will be 
printed. 



^ 
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The format of a printed sector is shown in section 11.4. 
11. 2. 7 Read sector into change buffer — R 



The R command is used to read a specified sector into 
the sector change buffer. Once the sector is in the change 
buffer^ changes can be applied to it. The sector change 
buffer can then be urritten back to diskette. The R command 
has several forms. Each form of the R command will 
initialize the sector address validity flag associated with 
the sector change buffer. This flag allows the change buffer 
to be re-u*ritten to the same sector from which it was read 
without specifying the sector address again. 

Command Effect 



RB 



RD m 



R m 



Read the Cluster Allocation Table into 
the sector change buffer. The RB command 
is only valid in the Physical Mode of 
operation. 

Read the specified logical sector of the 
directory into the change buffer. The RD 
command is only valid in the Physical 
Mode of operation. 

Read the specified sector into the change 
buffer. The current mode of operation 
will determine whether "m" is a logical 
or a physical sector number. 



11.2.8 Write change buffer into sector — W 



The W command is used to write the contents of the 
sector change buffer into a sector. The W command has 
several forms. 

Command Effect 



W Write the change buffer back into the 
sector from which it was originally read. 
This form of the W command is only valid 
if the U, Of C, or F commands have not 
been used since the sector change buffer 
was read into. 

CAUTION: THE FOLLOWING FORMS OF THE W COMMAND 
CAN DESTROY SYSTEM TABLES OR USER DATA IF USED 
INDISCRIMINATELY. USE OF THE FOLLOWING FORMS 
SHOULD BE RESTRICTED TO DISKETTE REPAIR 
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FUNCTIONS. 

WB Write the contents of the sector change 
buffer into the Cluster Allocation Table. 
The WB command is only valid in the 
Physical Mode of operation. 

WD m Writs the contents of the sector changs 

buffer into logical sector "m" of the 

directory. The WD command is only valid 
in the Physical Mode of operation. 

W m Write the contents of the sector change 
buffer into sector "m". The current mode 
of operation will determine whether "m" 
is a iggical or a physical sector number. 
If the" current mode of operation is the 
Logical Mode, then iariting past the 
end-of-file sector mill cause the CAT and 
the file's RIB to be updated in the event 
that additional diskette space is 
allocated. 



11.2.9 Fill change buffer — F 



The F command is used to fill the sector change buffer 
ujith a certain bit pattern or a certain ASCII character. The 
format of the F command is: 

F c or F "a" 

inhere the first form will fill the buffer with the 

hexadecimal bit pattern "c", and the second form will fill 

the buffer with the character "a". The sector address 

associated with the sector change buffer is invalidated by 
the F command. 

U. 2. 10 Examine/change sector buffer 

A special command is used for examining/changing the 
individual bytes of the sector change buffer. In order to 
gain access to a specific byte of the sector change buffer, 
the offset must be specified in the following manner: 

b/<cr> 

where "b" is a hexadecimal number <400-7F). The slash 
character causes the location at offset "b" to be "opened" 
and its contents displayed. After a partic.ul.ar location has 
been opened in this manner, the change buffer can be examined 
or changed a byte at a time by using the following commands: 
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C<str>3<cr> 

or 
L<str>D^<cr> 

or 

C<str>3/<cr> 

The element string <:str> will cause successive bytes of the 
change buffer to be changed to the respective values of 
<5tr>. If <str> is not specified, no changes will be applied 
to the change buffer. The <cr> only tuill cause the next 
offset of the change buffer to be opened and displayed. The 
"•''<cr>" will cause the previous location of the change buffer 
to be opened and displayed. The "/<cr>" will cause the 
current location to be closed and the examine/change mode tu 
be terminated. 

The initial command used to enter the examine/change 
mode can also take on the foiloujing forms: 

b/<str><cr> 



which will 
at offset 
Then the 
disp layed. 
commands. 



cause the locations of the change buffer starting 
"h" to be changed according to the string <str>. 
location after the last one changed will be 
The operator can then enter other examine/change 
If the initial command has the form: 

b/<5tr>/<cr> 



then the same function will be performed as in the previous 
command; however, instead of remaining in the examine/change 
mode, the normal command mode is entered. 

11.3 Messages 



The following messages can be displayed by the DUMP 

command. Not ail messages are error messages; however, error 

messages are included in the list. The standard error 

messages that can be displayed by all commands are not listed 
here. 



WHAT? 



The command issued in response to the DUMP input 
prompt was not recognized. A new input prompt is 
displayed. 
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SYNTAX ERROR 



The command issued in response to the DUMP input 
prompt was recognizedi however. it uias 
parameterized illegally. A new input prompt is 
displayed. The command has not been processed. 



MODE ERROR 



The Bi C^ or D q.ualifisT' was used isjith the Si L* 
R> or W command 'jjhile in the Logical Mode of 
operation. These forms of the commands are only 
valid in the Physical Mode. 

BOUNDARY ERROR 

The offset "b" in the examine/change command uas 
outside the range of the sector change buffer 
{$00-7F). or a subsequent location mas to be 
displayed which uias outside the range of the 
sector change buffer. The examine/change mode is 
terminated. 

INVALID SECTOR ADDRESS 

The sector address associated with the sector 
change buffer has been invalidated. In this 
case, the W command cannot be used without 
specifying a sector address. 



PHYSICAL MODE 



This message is displayed initially when the DUMP 
command is entered and the mode of operation is 
the Physical Mode. If the message is not 
displayed and if no error messages are shown, the 
Logical Mode of operation is initially in effect. 
Subsequent mode changes must be kept track of by 
the operator. 



»* 21 END OF FILE 



This message indicates that a logical sector 
beyond the logical end-of-file was to be read 
uiith one of the DUMP commands. In the Logical 
Mode of operation only sectors allocated to the 
file can be read. 



./ 
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**PROM I/O ERR0R-STATUS=36 AT h DRIVE i-PSN j 



This messa 
beyond the 
u/ith one o 
Mode of 
( single-si 
can be 
mean ingf u 1 
for the 
substitute 
sector nu 
is substit 



ge indicates that a phi^sic 

end of the diskette mas to b 

f the DUMP commands. In the 

operation) only sector 

ded) or sectors 0-$FA3 <dou 

accessed. A memory addr 

for system diagnostics) is s 

letter "h"; the logical unit 

d for the letter "i"; and the 

mber <PSN) at tuhich the erro 

uted for the letter "j". 



si sector 
e accessed 

Physical 
s 0-«7Dl 
ble— s ided ) 
ess (only 
ubsti tuted 
number is 

physical 
r occurred 



The display format of a sector's contents is shouin in 
section 11.4. The messages associated with that display are 
= »r.iai«Qrf hoT-o The sector disoiau will contain headings to 
identify mhat sector is being displayed. 



"UNIT" will alujays 
logical unit number. 



specify the currently selected 



The heading "CHANGE BUFFER" will 
sector change buffer is being shown. 



be displayed, if the 



The heading "CLUSTER ALLOCATION MAP" indicates that the 
B qualifier was used with either the S or L command. 
Likewise* the heading "DIRECTORY" indicates that the D 
qualifier was used with either the S or L command. 

The beading "FILE=x x x x x x x x. xx" indicates that the 
Logical Mode of operation is in effect. The file's name and 
suffix are displayed to the right of the equal sign. 

"PSN" gives the displayed sector's physical sector 
number, regardless of the mode of operation. "LSN", or 
logical sector number, is only shown if the directory is 
being displayed or if the current mode of operation is the 
Logical Mode. 

The digits 00-70 down the left edge of the display are 
the hexadecimal offsets into the sector. The contents of the 
sector are shown both in hexadecimal and in displayable 
ASCII. Non-displayable characters are printed as periods 
(. ). 

If sectors are displayed on the line printer, they will 

appear five sectors per page. The unit number and associated 

heading will be automatically printed at the top of each 

page. The paper alignment will be restored once the Q 
command is issued. 
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11. 4 Examples 



The follouiing example shows hou the Cluster Allocation 
Table is displayed with the DUMP command (a single-sided 
diskette is used). 

=DUJ1F 

PHYSICAL MODE 
: SB 

UNIT=0 CLUSTER ALLOCATION MAP 



00 

1 n. 

A ^^ 

20 
30 

40 
50 
60 
70 



PSN=0G01 

FF FF FF 
cp cjr irp 

FF FF FF 

00 00 00 

FF FF FF 

FF FF FF 

FF FF FF 

FF FF FF 



pp ^ZT^ pF Fp FF FF FF FF FF FF FF FF FF 

FF FF FF FF f¥ FF WF Fr FF FF FF FF FF 

FF FF FF FF FF FF FF FF FF FF FO 00 00 

Q3 pF pF FF FF FF 00 00 00 00 00 OF FF 

FF FF FF FF FF FF FF FF FF FF FF FF FF 

FF FF FF FF pp ff PF FF FF FF FF FF FF 

FF PFFF FF FF FF FF FF FF FF FF FF FF 

FF FF FF FF FF FF FF FF FF FF FF FF FF 



Q 



The next example illustrates how the logical 
zero through three of the directory ars displayed. 



sectors 



=DUMP 

PHYSICAL MODE 
: SD 0, 3 

UNIT=0 DIRECTORY 



PSN=0003 

00 42 49 4E 45 

10 42 55 49 4C 

20 4C 49 53 54 

30 00 00 00 00 

40 00 00 00 00 

50 00 00 00 00 

60 00 00 00 00 

70 00 00 00 00 



5S 20 
44 20 
20 20 
OO 00 
OO 00 
00 00 
00 00 
00 00 



20 20 
20 20 
20 20 
00 00 
00 00 
00 00 
00 00 
00 OO 



LSN=OO00 
43 4D 01 
43 4D 01 
43 4D 02 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 



4C 72 00 00 00 

6C 72 00 00 00 

F8 72 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

OO 00 00 00 00 



3INEX 
BUILD 
LIST 



CM 
CM. 
CM 



Lr 

Ir 

r 



P3N=0004 

00 4D 44 4F 53 4F 56 30 20 

10 46 4F 52 54 20 20 20 20 

20 00 00 00 00 00 00 00 00 

30 00 00 00 00 00 00 00 00 

40 00 00 00 00 00 00 00 00 

50 00 00 00 00 00 00 00 00 

60 00 00 00 00 00 00 00 00 



LSN=0O0i 

53 59 00 5C 72 00 00 00 

43 4D 02 74 72 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 OO 00 00 00 

00 00 00 00 00 00 00 00 



MDOSOVO SY 
FORT CM 



70 00 00 00 00 OO 00 00 00 00 00 00 00 00 00 00 00 



\r 
tr 
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00 
10 
20 
30 
40 
50 
60 



00 
10 
20 
30 
40 
50 
60 
70 



PSN=0005 
44 49 52 
4D 45 52 
52 4C 4F 
00 00 00 
00 00 00 
00 00 00 
00 00 00 



I \J \J\J WW WW 



PSN=0006 
4D 44 4F 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 



20 20 
47 45 
41 44 
00 00 
00 00 
00 00 
00 00 



53 4F 
00 00 
00 00 

00 oo 
00 00 
00 00 
00 00 
00 00 



20 20 20 

20 20 20 

20 20 20 

00 00 00 

00 00 00 

00 00 00 

00 00 00 

r\n r\r\ nrv 

^/"V/ ^a/^ W"W 



56 34 20 
00 00 00 
00 00 00 
OO 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 



LSN=0002 
43 4D 01 
43 4D 03 
43 4D 04 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
on no o*^ 

^^^ %#^w W^rf 



B8 72 00 00 00 

28 72 00 00 00 

IC 72 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

00 00 00 00 00 

00 00 00 00 00 



DIR 

MERGE 

RLOAD 



CM 
CM 
CM 



. r 



LSN=0003 

53 59 00 88 72 00 00 00 MD0S0V4 SY. .v. 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 oo oo 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 



In the follou/ing example, the DUMP command is invoked 
luith a file name on the command line; hoinevev, the File name 
does not exist as it is specified (i.e., a suffix of spaces). 
The Physical Mode of operation is entered automatically. 
Then -the command is used to open the file. Subsequently, 
tujo sectors of the file are displayed. The logical sector 
numbers allow a user to examine the file's contents without 
knowing uihere the file is physically located on the diskette. 

=DUMP MDOSER 

** 04 FILE NAME NO J FOUND 
: MDOSER. SY 
: S 1.2 
UNIT=0 FILE=MDOSER . SY 





PSN=00A6 












LSN=0001 














00 


31 30 36 


81 


44 


55 


50 


4C 


49 43 41 


54 


45 


31 


46 


49 


. 06. DUPLICATE. FI 


10 


4C 45 31 


4E 


41 


4D 


45 


OD 


30 44 81 


30 


37 


81 


4F 


50 


LE. NAME. OD. 07. OP 


20 


54 49 4F 


4E 


81 


43 


4F 


4E 


46 4C 49 


43 


54 


OD 


33 


30 


TION. CONFLICT. 30 


30 


81 30 38 


81 


43 


48 


41 


49 


4E 81 41 


42 


4F 


52 


54 


45 


. 08. CHAIN. ABORTE 


40 


44 SI 42 


59 


81 


42 


52 


45 


41 4B 81 


4B 


45 


59 


OD 


33 


D. BY. BREAK. KEY. 3 


50 


31 81 30 


39 


81 


43 


48 


41 


49 4E 81 


41 


42 


4F 


52 


54 


1. 09. CHAIN. ABORT 


60 


45 44 81 


42 


59 


81 


53 


59 


53 54 45 


4D 


81 


45 


52 


52 


ED. BY. SYSTEM. ERR 


70 


4F 52 81 
PSN=00A7 


53 


54 


41 


54 


55 


53 81 57 
LSN=0002 


4F 


52 


44 


OD 


31 


OR. STATUS. WORD. 1 


00 


43 81 31 


30 


81 


46 


49 


4C 


45 81 49 


53 


81 


44 


45 


4C 


C. 10. FILE. isr. DEL 


10 


45 54 45 


81 


50 


52 


4F 


54 


45 43 54 


45 


44 


OD 


32 


34 


ETE. PROTECTED. 24 


20 


81 31 31 


81 


44 


45 


56 


49 


43 45 81 


4E 


4F 


54 


81 


52 


.11. DEVICE. NOT. R 


30 


45 41 44 


59 


OD 


30 


45 


81 


31 32 81 


49 


4E 


56 


41 


4C 


EADY, OE. 12. INVAL 


40 


49 44 81 


54 


59 


50 


45 


81 


4F 46 81 


4F 


42 


4A 


45 


43 


ID. TYPE. OF. OBJEC 
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50 54 81 46 49 4C 45 OD 30 

60 41 4C 49 44 SI 4C 4F 41 

70 53 OD 31 33 81 31 34 SI 
: Q 



46 81 31 33 81 49 4E 56 
44 31 41 44 44 52 45 53 
49 4E 56 41 4C 49 44 81 



T. FILE. OF. 13. INV 
ALIO. LOAD. ADDRES 
S. 13. 14. INVALID. 



The following example illustrates hou the DUMP command 
can be used to "fix" part ef the MDGS systers tables that uiefe 
found to be in error by the REPAIR command (Chapter 22). No 
discussion is given here of the REPAIR commandi however/ the 
example does show what the REPAIR command displayed insofar 
as diagnostic messages are concerned. These messages contain 
the required information needed by the operator so that the 
DUMP command can be used to "fix" the bad sector. The REPAIR 
command could show the following on the system console: 

'REPAIR 

DISK ID: MDdSOGOO 

VERSION: 03 

REVISION: 00 

DATE; 072578 

USER: SYS DEVELOPMENT DRVO 

06 03 01 TESTPROG. SA 05BC 0581 0000 

ILLEGAL ATTRIBUTE OR UNUSED BYTES. DELETE? N 

33 GOOD FILES 00 FILES WITH BAD RIBS 

RECONSTR.UCTED C. A. T. MATCHES DISK ' 



The first few lines show the contents of the 
line that begins with "06 03 01" shows t 
directory entry that has been found in error, 
line shows the error that REPAIR detected, 
the attribute bytes of the directory entr 
describes the format of the displayed direct 
that information* the operator knows that the 
is displayed as "0581". The error is 
significant byte of this field. It should be 
as shown. From the other information disp 
seen that this directory entry is the second 
the third sector (03) of the directo 
information the DUMP command is used to r 
containing the bad directory entry into t 
buffer. The buffer is modified so that the 
"00". In the following example, the sector 
displayed both before and after the modificat 



ID sector. The 

he contents of a 

The subsequent 

The error is in 
y. Chapter 22 
ory entry. With 

attribute field 
in the least 

zeroi not "81" 
layedi it can be 

entry (01) in 
ry. With that 
ead the sector 
he sector change 
"81" becomes a 
change buffer is 
ion. 



Such repair functions must be performed with extreme 
caution. The REPAIR command should always be run again after 
a system sector has been changed in this way to ensure that 
the change was made correctly. 



y 
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=DUMP 
















PHYSICAL MODE 










: RD 3 
















: S 
















CHANGE BUFFER 












PSN=0006 












00 


4D 


44 


4F 


53 


4F 


56 


34 


20 


10 


54 


45 


53 


54 


50 


52 


4F 


47 


20 


00 


00 


00 


00 


00 


00 


00 


00 


30 


00 


00 


00 


00 


00 


00 


00 


00 


40 


00 


00 


00 


00 


00 


00 


00 


00 


50 


00 


00 


00 


00 


00 


00 


00 


00 


60 


00 


00 


00 


00 


00 


00 


00 


00 


70 


00 


00 


00 


00 


00 


00 


00 


00 


: IS/ 
















18 


53 
















19 


41 
















lA 


05 
















IB 


BC 
















IC 


05 
















ID 


81 00/ 














: S 
















CHANGE BUFFER 












PSN=0006 












00 


4D 


44 


4F 


53 


4F 


56 


34 


20 


10 


54 


45 


53 


54 


50 


52 


4F 


47 


20 


00 


00 


00 


00 


00 


00 


00 


00 


30 


00 


00 


00 


00 


00 


00 


00 


00 


40 


00 


00 


00 


00 


00 


00 


00 


00 


50 


00 


00 


00 


00 


00 


00 


00 


00 


60 


00 


00 


00 


00 


00 


00 


00 


00 


70 


00 


00 


00 


00 


00 


00 


00 


00 


: W 
















: Q 

















s;t =;o nn op -rn rvo r\r\ nn MnncnUA ev ^ 

53 41 05 BC 05 81 00 00 TESTPROGSA. . . . 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 OO 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 



53 59 00 SB 72 00 00 00 MD0S0V4 SY. . r. 

53 41 05 BC 05 00 00 00 TESTPROGSA. . , . 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 

00 00 00 00 00 00 00 00 
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The ECHO command can only be used on an EXORciser II 
systsffi. ECHO causes ail subsequent input/output that is 
directed to the system console to also be printed on the line 
printer. The ECHO command is also used to stop echoing 
console 1/U on the printer. 



12. 1 Use 



line: 



The ECHO command is invoked 



ECHO C;<options>3 



where <options> can be the letter "N". If the ECHO command 
is invoked uiithout any options* then all sub5eq.uent input and 
output to the system console via the MDOS console driver or 
the EXbug entry points will be duplicated on the line 
printer. . The line printer uill continue to receive a copy of 
all console I/Q until the ECHO command is invoked with the 
"N" option. 

The "N" option will turn off the echo feature. No 
paging is performed. Thus* if paper alignment is critical. 
it will have to be manually reset after the echo feature is 
disabled. 

12. 2 Messages 



The following messages can be displayed by the ECHO 
command. 

ECHO NOT AVAILABLE WITH EXBUG 1 

The ECHO command was invoked on an EXORciser I 
system. The command has no effect on such 
systems. 

** 11 DEVICE NOT READY 

The printer was not ready when the ECHO command 
was invoked. The command has had no effect on 
the system. The printer must be readied and the 
ECHO command invoked again if the echo feature is 
to be enabled. 
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13. EMCOPY COMMAND 

The EMCOPY command alloms files from a user's EDOS 2 
3-stsin diskstts to be copied to and catalogued on an MDOS 
diskette. Options exist for copying the entire diskette, 
selected files, or single files. 

13. 1 Use 

The EMCOPY command is invoked with the foiloujing command 
1 ine '. 

EMCOPY C<name l>]Ci<name 2>1 C; <op tions>: 

where <name 1> is the name of an EDOS file, <name 2> can be a 
neuj name that is to be used for <name 1> on the MDOS 
diskette, and <option5> can be one or more of the option 
letters defined beloui. If neither of the two file names is 
entered on the command line, then an <option5> specification 
must be present. The follouing option letters are available. 
They avs described, in detail in the following sections. 

Option Function 

A File is of the ASCII record format. 

R File is of the binary record format as 
created by the Macro Assembler tuith the 
OPT REL option. 

D Set the delete protection on the MDOS 

file. 

C Create the MDOS file uith contiguous 
space allocation. 

S Copy selected files from the EDOS 
diskette. 

E Copy the entire EDOS diskette. 

For each of the different ways that EMCOPY can be used, 
the EDOS diskette must always be in drive one and the MDOS 
diskette in drive zero, regardless of whether a two-drive or 
a four-drive system is being used. 
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13. 1. 1 Single file copy "^ 



If a single EDQS file is to be copied to the MDOS 
diskette^ -its name must be specified as <name 1>. Only EDOS 
file names that meet the MDOS criteria for valid file names 
can be copied (see section 2.7.1). Since EDOS file names are 

-— 1 >. Oi^.s ^ h =». = f- ■»■ a-j» = 1 nr>n anrf hava nn SU^'PiseS- ■Cn^de 1^ IS 

not specified with a suffix. Only the first five characters 
of <name 1> will be used to search the EDOS directory.- A 
logical unit number should not be specified for <name 1>. 
The options "E" or "S" cannot be specified on the command 
line if only the single file <name 1> is to be copied. An 
error will be displayed if <name 1> cannot be found in the 
EDOS directory. 

If no <name 2> is given on the command iine> then an 
MDOS file ijith the name of <name 13^ and the default suffix 
"ED" will be used as the destination file on drive zero. The 
default suffix can be overridden by specifying only a suffix 
for <name 2>. The default name can also be overridden by 
specifying a file name for <name 2>. 

In either case^ uihether an explicit or a default <name 
2> is usedi a file ujith that name must not already exist on 
the MDOS diskette.. , A standard error message luill be 
displayed' if <name 2> already exists. 

If no option or if the "A" option is specified on the 
command line, EMCOPY will assume that the EDOS file is in the 
ASCII record format. The "R" option can be used to copy EDOS 
files that were created by the EDOS Macro Assembler with the 
relocatable option (OPT RED. Obviously* "R" and "A" cannot 
be specified at the same time. If the EDOS file is found 
with the "Permanent Attribute" set, then the MDOS file will 
be automatically created with delete protection. The delete 
protection can be explicitly set for the MDOS file by using 
the "D" option on the command line. 

13.1.2 Entire diskette copy 



To cop-y all valid EDOS files from drive one to the MDOS 
diskette in drive zero, no file name specification must be 
given for <name !>> no file name must be given for <name 2> 
^however, a suffix can be specified), and the "E" option must 
be specified. 

The EDOS diskette will have its entire directory 
searched* one entry at a time* for valid (MDOS compatible) 
file names. When a valid name is found* it will be given the 
default suffix "ED" or the explicit suffix specified by <name 
2>, and copied to the MDOS diskette. Of course* a file with 
that name cannot already exist on the MDOS diskette. This 
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process is repeated until all entries in the EBGS dirsctcry 
have been examined. 

As file nasnes are processed from the EDOS directory one 
of the following two messages uiill be displayed for each file 
name. The message 

COPYING FILE: <name> 

indicates that the EDOS file identified by <naroe> is being 
transferred to the MDOS diskette. The message 

<name> 

*» 25 INVALID FILE NAME 

indicates that the file <name> does not have a valid MDOS 
file name and cannot be copied. __If the file is to be =°P^sd^ 
it must first be renamed on an tuus system using the RENAM 
command. 

The "C". "D'S "R" ! or "A" options can be specified on 
the command line. These options, explained in the previous 
section, can be used to assign attributes to all files copied 
from the EDOS diskette. If no options avs specified, then 
the MDOS files will use segmented allocation and be of the 
ASCII record format. The delete protection will 
automatically be set for files with the "Permanent Attribute- 
on the EDOS diskette. 

The "S" option cannot be specified at the same time as 
the "E" option. 

13.1.3 Selected file copy 



To copy only selected files from the EDOS diskette, the 
"S" option must be specified on the command line. Nothing 
can be specified for <name 1> or <name 2> if the "S" option 
is used. Basically, the selected file copy mode works like 
the entire diskette copy modei however, the operator can 
assign different attributes and suffixes to each file, as 
well as deciding whether or not a particular file is to be 
copied at all. During the selected file copy mode, as valid 
file names are found in the EDOS directory, the message 

COPY <name> ? 

will be displayed. The operator must respond with a "Y" if 

the file is to be copied to the MDOS diskette. Any other 

response will cause that file to be bypassed and not copied. 

The next valid file name will then be searched for. 

I-p a "Y" response is given to the above prompt, EMCOPY 
will display two additional prompts: 
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SUFFIX? 

ATTRIBUTES? 

The operator can assign an explicit suffix by entering it 
gfter the "SUFFIX?" prompti and he can assign explicit 
attributes by entering the appropirate attribute letters (A. 
C, D, R) after the "ATTRIBUTES?" prompt. The default suffix 
"ED" and the default attribute "A" can be assigned by 
responding with only a carriage return. If an invalid 
attribute is entered by the operator, the "ATTRIBUTES?" 
prompt will be redisplayed, farcing the operator to enter neu» 
attributes. This procedure uill continue until all entries 
from the EDOS directory have been processed. At that time 
the message 

NO MORE FILES 
uiil be displayed and control returned to MDOS. 
13.2 File Differences Between EDOS and MDOS 



Both EDOS and MDOS systems support the ASCII and the 
binary record format. The ASCII record format is primarily 
used for source program files and abject program files in the 
EXbug-loadable format. The binary record format is used 
primarily for the relocatable object output files created by 
the Macro Assembler, RASM. 

The EMCOPY command will transfer either type of file on 
a sector-by-sector basis. Thus', after a file is copied to 
the MDOS diskette, its sectors are still in the same internal 
format; however, when an ASCII record file is processed by 
the MDOS editor, it w'i 1 1 be altered. Multiple spaces will be 
compressed into a single byte, and the carriage return, line 
feed, null sequence that terminates all ASCII records on EDOS 
files will be replaced by a single carriage return. Thus, 
the resultant MDOS file will be significantly smaller than 
its original EDOS form. 

Space compression is, of course, not performed on the 
binary record filesi however, were the same object file to be 
produced by the MDOS Macro Assembler, it would not be 
identical to its EDOS counterpart. The carriage return, line 
feed, null sequence would have been replaced by a single 
carriage return. 

13. 3 Messages 

The following messages can be displayed by the EMCOPY 
command.' Not all messages are error messages, although error 
messages are included in the list. The standard error 
messages that can be displayed by all commands avs not listed 



^ 
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H fflT* 



re. 



COPYING FILE: <name> 



SUFFIX? 



During the entire diskette copy mode. this 
message monitors luhich files are being copied to 
the MDOS diskette. 



COPY <name> ? 



ATTRIBUTES? 



During the selected file copy mode/ this prompt 
alloius the operator to choose which files get 
copied. A "Y" response will cause <name> to be 
copied. Any other response will cause <name> to 
be bypassed. 



This prompt allows the user to specify an 
explicit two-character suffix during the selected 
file copy mode. A response of carriage return 
only will cause the default suffix "ED" to be 
used. 



This prompt allows the user to specify explicit 
attributes during the selected file copy mode. 
The attribute letters "A", "C", "D"- or "R" can 
be entered. A response of carriage return only 
will cause the "A" attribute to be used. 



NO MORE FILES 



The EDOS directory has been exhausted during 
selected file copy mode. 



the 



13. 4 Examp les 



The following example illustrates how 
TESTP from an EDOS diskette would be copied 
TESTPROG. SA on an MDOS diskette. 



the single file 
into the file 



T *■ 



w 



1 1 



EMCOPY TESTP, TESTPROG. SA 

The MDOS file will be allocated segmented space. 

in the ASCII record format. The file may be delete protected 

if the EDOS file had the "Permanent Attribute" set. 

The following example shows how an entire EDOS diskette 
is copied. The first two files are not . copied since their 
file names are not valid MDOS file names. It should be noted 
that <name 1> is not specified. Thusi in order to specify a 
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suffix for <name 2>. the comma had 
that <name 1> is null/ or missing. 
u)ill be used instead of the default 
copied to the MDOS diskette. Since 
given, all files uiill be created in 



to be entered to indicate 
The <name 2> suffix "SA" 
suffix "ED" far all files 
no other options uere 
the ASCII record format. 



=£MCOPY , . SAi E 

$DQS 

»* 25 INVALID FILE NAME 

«DIR 

»* 25 INVALID FILE NAME 



COPYING 


FILE 


PRNTX 


COPYING 


FILE 


0120 


COPYING 


FILE 


OMEX 


COPYING 


FILE 


OXRF 


COPYING 


FILE 


ONOL 


»* 06 DUPLICATE FIL 


COPYING 


FILE 


OLIS 


COPYI.NG 


FILE 


ONMC 


COPYING 


FILE 


DASM 


COPYING 


FILE 


DUP05 


COPYING 


FILE 


OOIK 


COPYING 


FILE 


OOPl 


COPYING 


FILE 


TITLE 


COPYING 


FILE 


PAGE 


COPYING 


FILE 


PCHO 


COPYING 


FILE 


RSMB 



»* 41 INSUFFICIENT DISK SPACE 



The file ONOL was not copied because the MDOS file ONOL. SA 
already existed. The file RSMB uas partially copied. The 
MDOS diskette lacked sufficient space for that EDOS file. 
The EMCOPY is stopped at that point since subsequent files 
would probablij not have room either. Files like RSM5> RLOAD, 
ASMBi and EDIT on EDOS diskettes should not be copied to MDOS 
diskettes* since those programs make assumptions about the 
diskette structure, and will fail to work if copied and 
executed (after EXBIN conversion). 
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=EMCOPY ;S 

$DOS 

** 25 INVALID FILE NAME 

*DIR 

** 25 INVALID FILE NAME 

COPY PRNTX? 

Y 

SUFFIX? 

RO 

ATTRIBUTES? 

R 

COPY 0120 ? 

COPY OMEX ? 

COPY OXRF ? 

COPY ONOL ? 

Y 

SUFFIX? 

ATTRIBUTES? 

COPY OLIS ? 

COPY ONMC ? 

COPY DASM ? 

COPY DUP05? 

COPY OOIK ? 

COPY OQPl ? 

COPY TITLE? 

COPY PAGE ? 

COPY PCHO ? 

COPY RSMB ? 

NO MORE FILES 
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14. EXBIN COMMAND 



The EXBIN command is used to convert files in the 
EXbyg— ioadab l9 format Ce. g, ^ object output rrora the assembly 
process ujithout the OPT REL or OPT ABS directive) into Piles 
that can be loaded into fnemory for execution. The EXBIN 
command performs the inverse operation of the BINEX command. 

14. 1 Use 



The EXBIN command is invoked uiith the follouiing command 
line: 

EXBIN Cname 1>C, <name 2>1 C;<options>3 

where <name 1> is the file specification of an EXbug-loadafa le 
file that is to be converted. and <name 2> is the file 
specification of a file that is to receive the results of the 
conversion. Only <name 1> is required to be entered on the 
command line. The default suffix "LX" and the default 
logical unit number zero will be supplied for Cname 1> if 
those quantities are not explicitly given. The output file 
specification* 'Cname 2>< is optional. If <name 2> is 
entered, it may be a partial file specification consisting of 
only a file name* a suffix, or a logical unit number (or any 
combination thereof). The unspecified parts of <name 2> will 
be supplied from the respective parts of <name i>. with the 
exception of the suffix. The default suffix for <name 2> is 
"LO" to indicate its memory-image format. If no file 
specification is given for <name 2>> the output file will be 
created with the same file name as <name 1> but with the 
suffix "LO". If only a suffix is given for <n3me 2>, that 
suffix will be used instead of the default "LO". If no 
logical unit number is given for <name 2>.. the output file 
will be created on the same drive as given for <name 1>. In 
any case. <name 2> must be a file specification for which no 
entry already exists in the directory. 

Standard error messages will be displayed if <name 2> 
already exists* if <name 1> does not exist.- or if <name 1> is 
of the wrong file format. 

The <:options> field can be used to specify a starting 

execution address for the memory-image file. If no <options> 

field is given. EXBIN will use the address contained in the 

S9 record for the starting execution address. 

EXBIN will ignore the SO. or name record, as well as any 
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null records from <name 1>. Null records consist of a 
carriage return onl«. The content of the SI records uiill be 
converted to its binary equivalent and written into <naffle 2>. 

Since the EXbug-loadable files can contain SI records 
that uiould be loaded into non-adjacent blocks of "^^^^^ ^^^f, 
on their address fields, the resulting memory-image file may 
be ia^g^'t^ Coccu?-4 fflorg diskette space) than <name 1>. This 
results from the fact that <name 2> is a memory-image file. 
All parts of memory u,hich are not directly referenced by the 
SI records, but mhich are included between the lowest and the 
highest address contained in all SI records, uiill be ^ P^^* 
of the memory-image in the file <name2> (initialized to 
binary zeroes). 

The EXbug-loadable file, <name_l>. is unaffected by^ the 
entire EXBIN conversion process. The output file. <nau.« 2>, 
can then bs loaded into memory directly from diskette using 
the LOAD command <see Chapter IS). 

14.2 Execution Address Specification 



A starting execution address for the memory-image file 
can be specified by entering a valid hexadecimal number in 
the <options> field. The number must be m the range 
$0000-FFFF (entered in the <options> field uiithout the <iolljT 
sign) In addition, the execution address must fall uithin 
the range of addresses spanned by the file. That is, the 
starting execution address cannot be less than the loudest 
address found in an SI record, and it cannot be greater than 
the highest address. If an execution address is specified in 
the <options> field, it will override any value contained in 
the S9 record of <name 1>. 

14. 3 Error Messages 



The following error messages can be displayed by the 
EXBIN command. The standard error messages that can be 
displayed by all commands are not listed here. 

CHECKSUM ERROR 

One of the S records from <name 1> contained an 
invalid checksum. 
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RECORD FORMAT ERROR 

One of the records from <name 1> was not in the 
EXbug-loadab le format. Exceptions to this are 
null recordsi or records which consist of only a 
carriage return. Null records are simply dropped 
and ujill produce no errors. Otherwise* only 
records beginning with SO. Sl» or S9 are 
acceptable. If all fBCSTds do begin with these 
characters when this error occurs, then something 
else is wrong with their format. The "M6S00 
EXORciser User's Guide" contains a complete 
description of the S record format. 

SOURCE FILE NOT ASCII 

The file <nams 1> is not in the ASCII record 
format. EXbug-loadab ie files must be ASCII. 

START ADDRESS OUT-OF-RANGE 

The starting execution address specified in the 
<option5> field or the address contained in the 
S9 record is not within the range of memory 
addresses spanned by the file. 

** 30 INVALID EXECUTION ADDRESS 

Normally. this standard error message has a 
slightly different meaning. During the EXBIN 
process, however, this error indicates that the 
starting execution address given in the <options> 
field was not a valid hexadecimal number. 

14. 4 Examp les 

Most frequently, the default suffixes and logical unit 
numbers suffice for the EXBIN operation. The following 
command line 

EXBIN TESTPROG 

will produce the file TESTPROG. LO on logical unit zero from 

the EXbug-ioadable file TESTPROG. LX. also on logical unit 

zero. The starting execution address from the S9 record will 
be used. 

The following command line 

EXBIN TESTPROG, : 2; 2100 

will create the same file as in the previous example. In 
this case, however, the file is created on logical unit two. 
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The starting execution address «2100 will be assigned to the 
output file, regardless of what is contained in the S9 
record. 
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15. FORMAT COMMAND 

The FORMAT command attempts to rewrite the sector 
-.^^»s<: s '! nn < ■nfin-r<.fns*-i nn nn Hickottes The FORMAT CQflimsnd can 
be used to reformat either single-sided or double-sided 
diskettes; however, double-sided diskettes must be formatted 
with this command before they can be used with MDOS. 
Single-sided diskettes usually come pre-f ormatted in a 
compatible format. The FORMAT command will only work on 
systems that are operating at one of the standard clock 
frequencies of 1 MHZi 1. 5 MHz* or 2 MHz. 

15. 1 Use 

The FORMAT command is invoked with the following command 
line: 

FORMAT C: <unit>3 

where <unit> is an optional logical unit number. If 

specified, <unit> can take on the values 1-3. If <unit> is 

not specified, logical unit number one will be used as a 
default. 

If a user has a dual-drive EXORdisk II system, there is 
no need for him to specify a <unit> on the command line. If 
he does, caution must be used since- the specification of 
logical unit number 2 on a EXORdisk II system will cause 
logical unit number zero to be formatted due to the way the 
disk controller works! 

Since the FORMAT command will destroy all information on 
the diskette in the specified drive* the prompt 

FORMAT DRIVE <unit>? 

will be displayed, where <unit> indicates the logical unit 
number containing the diskette to be formatted. <unit> is 
either the number entered on the command line, or the default 
value supplied by the command itself. Any response other 
than "Y" will cause the FORMAT command to be terminated and 
control returned to MDOS. In this case, the diskette in the 
specified drive is unaffected. If the "Y" response is 
entered, the operator should have placed a diskette that 
needs to be formatted into the specified logical unit. 

FORMAT will then proceed to: 
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1. Rewrite the soft sector addressing information on - \ 
each cylinder (Appendix F contains a description 

of the diskette format). 

2. Initialize every byte of each sector to the 
hexadecimal value $E5. 

are good and that the diskette is readable. 

The above process terminates when the diskette is 
completely formatted or when a diskette controller error 
occurs repeatedly. In the former case? control is returned 
to MDOS. In the latter case, the FORMAT command will display 
the diskette controller error with the standard "PROM I/O" 
error message. The diskette is not necessarily unusable if 
such errors occur. The FORMAT command should be re-run after 
having noted the physical sector number at uihich the error 
occurred. If the same error occurs at the same physical 
sector number after three attempts at running the FORMAT 
command. then the oxide on the diskette is probably damaged. 
The diskette is unusable in such cases. If the unusable 
diskette is inspected carefully by manually turning the 
diskette within its protective envelope. a mark or 
indentation can usually be found on its surface. 

The FORMAT command can be used to format single-sided 
diskettes on the single— and double-sided Calcorap EXORdisk 
II/III systems or on the single-sided Pertec EXORdisk II 
systems. however. double-sided diskettes can only be 
formatted on the double-sided Calcomp EXORdisk III systems. 

15. 2 Messages 



The only messages that the FORMAT command can display 
ar9 the prompt shown above, asking if the diskette in the 
specified <unit> is to be formatted, and the standard PROM 
I/O error message. indicating that a diskette controller 
error was encountered during the formatting process. 

15. 3 Example 



The following example shows the FORMAT command being 
used repeatedly after an error is detected. Since the 
physical sector number of the error keeps increasing, it 
indicates that the FORMAT command is able to rewrite more and 
more of the diskettes however, at one point, the physical 
sector number is always the same. At that time the FORMAT 
command is not used any longer since the diskette in drive 
one is unusable. 
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=FORMAT 

FORMAT DRIVE 1? 

Y 

»*PROM I/O ERRGR-STATUS=3S AT 2006 ON DRIVE 1-PSN 01D8 

=FORMAT 

FORMAT DRIVE 1? 

Y 

**PROM I/O ERRaR-STATUS=38 AT 2006 ON DRIVE 1-PSN 01F2 

— C-nOMAT 
■~*l uff \i in I 

FORMAT DRIVE 1? 

Y 

**PROM I/O ERR0R-STATUS=3S AT 2006 ON DRIVE 1-PSN 0226 

=FORMAT 

FORMAT DRIVE 1? 

Y 

»*PROM I/O ERR0R-STATUS=31 AT 2006 ON DRIVE 1-PSN 0226 

=F0RMAT 

FORMAT DRIVE 1? 

Y 

**PROM I/O ERR0R-STATUS=31 AT 2006 ON DRIVE 1-PSN 0226 
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16. FREE COMMAND 

The FREE command displays the number of unallocated 
sectors and the number of empty directory entries remaining 
on a diskette. 

16. 1 Use 



The FREE command program is invoked with the follouing 
command line: 

FREE C:<unit>3 C;<option5>3 

where <unit> can be the logical unit number 0. 1. 2/ or 3/ 
and <options> can be the letter "L". If the <unit> is not 
specified on the command line, the default value zero will be 
used. 

The FREE command normally displays its summary data on 
the system console. The option "L" > however, can be used to 
direct this data to the line printer instead. After the FREE 
command has determined the available space on the diskette, 
the data will be displayed in the following format: 

DRIVE i xxxxxxxx 

aaaa/*bbb SECTORS ccc/*dd FILES 
eeee/Sfff LARGEST CONTIGUOUS BLOCK 

The symbols have the following meanings: 

Symbol Meaning 



i Logical unit number selected, 

xxxxxxxx Eight character diskette ID. 
aaaa Available sectors in decimal. 

*bbb Available sectors in hexadecimal, 
ccc Available directory entries in 

decimal. 
*dd Available directory entires in 

hexadecimal, 
eeee Size of largest, available block of 

contiguous sectors in decimal. 
$fff Size of largest, available block of 

contiguous sectors in hexadecimal. 
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FREE COMMAND 

16. 2 Example 

The folioufing example shows the output from the FREE 
command af SispLyed on the system console <a double-sided 
diskette is used). 

sFREE : 3 

DRIVE 3 : MDQS03O0 

3004/*BBC SECTORS 124/*7C FILES^ 
0212/*0D4 LARGEST CONTIGUOUS BLOCK 



The last example uses a single-sided diskette. 
,nit> is entered on the command line, so the default of 



No 
zero 

VUI 

e itcaH 



=FREE 

DRIVE : MD0S03O0 

0820/5334 SECTORS 140/S8C FILES 
0064/$040 LARGEST CONTIGUOUS BLOCK 



y 
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17. LIST COMMAND 

The LIST command is used to print any ASCII file on 
either the system console or the printer. Options esist for 
numbering lines, specifying page formats, printing headings* 
and indicating starting and ending points. In addition.- 
files can be accessed by their logical sector numbers for 
rapid access to any portion of a file. 

17. 1 Use 



The LIST command is invoked with the follouiing command 
1 ine: 

LIST <name>C, C<start>jC/ <end>l J C;<options>3 

where <name> is the file specification of an ASCII file that 
is to be displayed* <start> and <end> are the optional 
starting and ending points of the display* and <options> can 
be one or more of the option letters described below. 

.Option Function 

L Display file on line printer. 

H Get heading information from system 
console. 

N Display physical line numbers for each 
line. 

F Use a non-standard page format. 

The <name> parameter must be specified with the LIST 
command. If no suffix is given, the default value "SA" will 
be supplied. The default logical unit number is zero. 

The following sections describe each of the options in 
detail. The "L" option can be used with any other options to 
specify that the output from the LIST command is to be 
directed to the line printer. If the "L" option is missing, 
the system console will be used instead. 

If the ASCII file contains any non-displayab le 
characters, the LIST command will convert them into a percent 
sign (7.) so that they will be visible. If records ars 
contained in the file that srs longer than the selected page 
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format, they will be truncated on the right before they are 
displayed. 

17. 1. 1 Start/end specifications 



The default starting point for the display is the first 
physical line of <n3,T!S>. The default ending point is the 
last physical line. The <start> specification can be used to 
start the display of the file at a specific physical line 
number or at a specific logical sector number. If the 
<:start> specification is present on the command line it must 
ba in one of the following tuio formats: 

Lnnnnn 

or 

Smtnfli 

The "Lnnnnn" form is used to specify a starting physical line 
number. The value "nnnnn" must be a 1-5 digit decimal number 
in the range 1-65535, inclusive. The "Smmm" form is used to 
specify a starting logical sector number. The value "mmm" 
must be a 1-3 digit hexadecimal number in the range SO-FFF, 
inclusive. The default <start> specification is "LI". 

The <end> specification can be used to specify inhere the 
display of the file is to stop. The <end> specification has 
the same . two forms as the <3tart> specification. If no 
<start> specification is entered on the command line, then 
the Cend> specification can be of either form; however, if 
the <start> specification is entered, then the <Bnd> 
specification must be of the same form. For example, it is 
invalid to specify a <start> specification of logical sector 
five and an <end> specification of physical line 216. The 
<end> specification must be larger than the <start> 
specification. The default <end> specification is the 
logical end of the file. 

17.1.2 Physical line numbers 

Normally, the displayed file will not be shown with 
physical line numbers. Only the actual data of the lines in 
the file will be shown. The "N" option can be used to cause 
physical line numbers to be generated by the LIST command and 
displayed with each line of data from the file. The physical 
line numbers will be printed as five digit decimal numbers. 
If the standard page format is used, each data line that is 
longer than the eighty characters will be disp layed . with 
eight fewer data characters, truncated from the right. The 
physical line numbers are useful luhen using the BLOKEDIT 
co.mmand (Chapter 5) or when trying to find verify errors from 
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the COPY command (Chapter 7) between a diskette file and a 
tape file. 

The physical line number option "N" is fairly 
meaningless if the logical sector form of the <start> 
specification is used. Since no count is available for the 
number of lines between the beginning of the file and the 
specified logical sector. the physical line numbers (if 

|.blfVCW/ U*WWAW WII^Y ht %m I^*^V*TW V** wilt ff O i w wi vji^ t m ^ -m. wii^v 

uas displayed. A partial line will usually be seen as the 
first line since the records randomly cross sector 
boundaries. 

17. 1.3 Usei — supplied heading 



Normally.- the LIST command will print a page number and 
the file name specification of the file being listed as a 
heading. The "H" option can be used to cause additional 
information to be displayed on the heading line. The "H" 
option will cause the following prompt to be shown on the 
system console before the file is listed: 

ENTER HEADING: 

The operator can then respond with a line of text that is to 
be used as the heading. The maximum length of the entered 
heading is 100 (decimal) characters. The heading line 
containing the page number. file name specification. and 
user— suppl ied text will automatically be printed on the 
second line of each, page. 

17. 1. 4 Non-standard page formats 



Normally, the LIST command will display a maximum of 
eighty characters per line and sixty— six lines per page. The 
"F" option can be used to override the standard page format. 
The format of the "F" option is as follows: 

FCcccD. Cpp3 

where at least one of the two parameters must be present. 
The "ccc" parameter is used to specify the number of columns 
to be printed per line. It must be a decimal number in the 
range 1-132. inclusive. The "pp" parameter is used to 
specify the number of lines per page. It. too/ must be a 
decimal number, but in the range 10-99, inclusive. An error 
message will be displayed if an illegal page format is given. 
Either the line length or the page length can be specified 
without the other (e.g., "F20. " or "F. 58", respectively). 
Only the line length need be specified if longer lines are to 
be printed on a standard length page. 
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17. 2 Messages ~^ 



The following messages can be displayed by the LIST 

command. Not all messages are error messagesi however^ error 

messages are included in the list. The standard error 

messages that can be displayed by all commands are not listed 



here. 

PAGE ddd <naffle> 



This is the standard heading supplied by the LIST 

command, "ddd" is the decimal page number and 

<nams> is the file name specification, of the file 
being printed. 

ENTER HE A D I NG -. 

This message is displayed when the "H" option is 
used to print additional heading text on each 
page. A maximum of 100 (decimal) characters .can 
be entered. 

** 24 LOGICAL SECTOR NUMBER OUT OF RANGE 

This error is caused when a <5tart> specification 
references a logical sector number that is 
greater than the logical sector number of the end 
of file. 

** 34 INVALID START/END SPECIFICATIONS 

The <start> and <end> specifications on the 
command line were not both of the same form ("L" 
or "S"). or the <end> specification had a value 
that (uas less than the value of the <start> 
specification. This error can also be caused if 
the <start> or <end> specifications begin with 
letters other than "L" or "S". 

** 35 INVALID PAGE FORMAT 

The parameters of the "F" option did not meet the 
criteria explained in section 17.1.4. 

»* 36 FILE EXHAUSTED BEFORE LINE FOUND 

The <start> specification on the command line 

specified a physical line number luhose value was 

larger than the total number of lines in the 
file. 
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17. 3 Examples 



The MDOS equate file is used in all of the folloiiiirsg 
examples. The folloining example shows what is probably the 
most commonly used form of the LIST command. No options are 
used. The default values for suffixi logical unit number^ 
<5tart> and <end> specifications. page format/ and output 
ggvjce are usee. a v a3 aaawmcu wu^v wns wit^?nr\ ^^^ i«r-«.^ 
depressed to terminate the LIST command and return control to 
MDOS in this example. 



=LIST EQU 
PAGE 001 EQU 



. SA: 



* TURN OFF THE LISTING 
* 

OPT NOL 

PAGE 
■»■ 

» MDOS VERSION 03. 00 — SYSTEM EQUATE FILE 
* 

SPC 3 
* 



JULY 25, 1978 



The following example uses the <end> specification to 
stop on the tenth line of the file. Since the default value 
for the <:5tart> specification is to be used* a null parameter 
must be specified for it. This is done by entering the two 
adjacent commas. The "N" option causes the display of the 
physical line numbers. 

=LIST EQU, , LiO; N 



PAGE 001 EQU 



SA: 



00001 
00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 
OOOIO 



* TURN OFF THE LISTING 
•»• 

OPT NOL 
PAGE 
* 

* MDOS VERSION 03. 00 — SYSTEM EQUATE FILE — JULY 25, 197S 

SPC 3 



The following example uses both <start> and <end> 
specifications to cause the display of physical lines 30 
through 40, inclusive. 
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=LIST EQU, L30, L40 

PAGE 001 EQU . SA.O 

* THE SAME CONCEPT AS THE "SKIPS" MACRO IS USED, EXCEPT THAT 

» A "BIT TEST ACCUMULATOR A IMMEDIATE" OP CODE IS GENERATED. 

» 

SKIPl MACR 

FCB *85 

ENDM 

♦SCALL MACRO (SYSTEM FUNCTION CALL) 

3CALL MACR 
IFEQ NARG-1 



The following example illustrates how the logi 
number can be used to rapidly access any part 
When the <start> and <end> specifications refer to 
line numbers- the file must be read from the be 
record at a time^ in order to find the corre 
however, the logical sector form of the <start> spe 
permits the LIST command to go directly to the sec 
physical line number option "N" is fairly meaningl 
logical sector form of the <start> specification 
Since no count is available for the number of lin 
the beginning of the file and the specified logica 
the physical line numbers (if printed) would only b 
to the part of the file that was displayed. A par 
will usually be seen as the first line since t 
randomly cross sector boundaries. The BREAK key wa 
this example to terminate the display of the file. 



cal sector 
of a file, 
physical 
ginning* a 
ct lines; 
c if ication 
tor. The 
ess if the 
is used, 
es between 
1 sectori 
e relative 
tial line 
he records 
s used in 



=LIST EQU, S5 



PAGE 001 EQU . 



SA: 



TE" OP CODE IS GENERATED. 

* 

SKIPl MACR 

FCB *85 

ENDM 
« 

*SCALL MACRO 

# 
SCALL MACR 

IFEQ NARG-1 



(SYSTEM FUNCTION CALL) 



The following example displays the MDOS equate file 
using a non-standard line length specification. Only the 
first twenty characters of each line will be shown. Notice 



.^ 
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that this format also applies to the printed heading. 
BREAK key was used to terminate the display. 



The 



=LIST EQUiF20 
PAGE 001 EQU 



.S 



* TURN OFF THE LI ST I 
* 

OPT NOL 

PAGE 
* 

» MDOS VERSION 03. 00 
* 



The last example lists the first nine lines of the MDOS 
equate file. In addition to the previously shown featuras^ 
the "H" option is used to specify a heading. This heading 
would be printed at the top of each page if multiple pages 
(uere printed. 

=LIST EQU, , L9i HN 

ENTER HEADING: THIS IS THE MDOS SYSTEM EQUATE FILE 



PAGE 001 EQU 



SA: THIS IS THE MDOS SYSTEM EQUATE FILE 



00001 * 

00002 » TURN OFF THE LISTING 

00003 * 

00004 OPT NOL 

00005 PAGE 

00006 * 

00007 * MDOS VERSION 03. 00 — SYSTEM EQUATE FILE ~ JULY 25. 1978 

00008 » 

00009 SPC 3 
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18. LOAD COMMAND 



command is used to load a program from s 
Is on the diskette into memory. Options exist 
the debug monitor after loading a program, for 
a programi for loading a program into 
the User Memory Map of EXORciser II systems, and for loading 
a program over the resident operating system. 



Th e LOAD 
memory-image f 
for entering 
automatically executing 



le. 1 Use 



The LOAD command is most frequently used to load a 
program into memory for testing; however, certain types of 
programs, specifically those that overlay MDOS. that load 
outside range of contiguous memory knonw to MDOS, or that 
execute in the User Memory Map of an EXORciser II system with 
the dual memory map configured, can only 

one of its options (G). 

follouiing command line: 



LOAD command and 
invoked with the 



be executed via the 
The LOAD command is 



LOAD C<name>:] C><options>3 



where <name> is the file name specification of a file from 
which the program is to be loaded into memory, and <options> 
specifies how to load the program. If <name> is specified, 
it must be the name of a file that has the memory-image 
format. The default suffix "LO" will be supplied if no 
explicit suffix is given. The default logical unit number is 
zero. 

The <option5> are divided into "Main Options" and "Other 
Options". Main Options are mutually exclusive. That is, 
only one Main Option can be specified on the command line at 
a time. The Other Options can be included with any one of 
the Main Options. The following tables show both Main and 
Other Options. 



Page 18-01 



LOAD COMMAND 

Main Option Function 



18. 1 — Us( 



none Load program into contiguous 
memory above MDOS; keep MDOS SWI 
vector to allow system function 
access. 

U Load program into User Memory, Map 

of an EXORciser 11 system uiith a 
dual memory map configuration. 

V Allow program to load over MDOS 

or anyufhere else in memory; 
disable MDOS's SWI vector. 



Other Option Function 



none Enter debug monitor after loading 
program. 

Q Execute program. after loading. 

<<str>) Initialize MDOS command line 
buffer with the character string 
<str> as indicated in the 
enclosed parentheses. 

The <options> are discussed in detail in the following 
sections. 

The LOAD command does not verify that memory exists for 
the areas into which a program gets loaded. 
Command-interpreter-loadable programs (section 18.1.1) avs 
guaranteed that memory exists since the memory was sized at 
initialization timej however, programs loading into 
discontiguous areas of memory or into the User Memory Map of 
a dual memory map configuration are not guaranteed that 
memory exists. The operator is responsible for knowing where 
memory is configured in his system and where his programs ars 
loaded. Also, due to the nature of the diskette controller, 
it is not possible for the LOAD command to compare what is 
read from the file with what is stored into memory. Only 
diskette controller read errors can be detected. 

Programs brought into memory from the diskette will be 
loaded in multiples of eight bytes. This fact must be 
considered when programs are loaded into adjacent blocks of 
memory close to other programs, or if programs are loaded 
into the upper end of a block of memory. 



.y 
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LOAD COMMAND 

la. 1. 1 Command-interpretei — loadable programs 

Programs that can be loaded by the MDQS command 
interpreter are usually loaded for testing by not specifying 
anything in the <options> field. The "G" option can be used 
to load and execute the program in one step; however, for 
such programs this is awkward. They are usually loaded and 
executed directly by the MDOS command interpreter hu entering 
their file names as the first file name specification on an 
MDOS command line. The command line 

LOAD TESTPROG 

would attempt to load the file TESTPROG. LO from logical unit 
zero above the resident operating system (the program must 
have already been assembled at. or link/loaded and assigned 
memory locations at the proper addresses so it loads above 
MDOS). After the file was loaded/ control would be given to 
the debug monitor. 

The following command lines 

TESTPROG. LD 

or 

■ LOAD TESTPROG; G 

would load the program from TESTPROG. LO from logical unit 
zero and execute the program. It should be noted that these 
two command lines will accomplish the same function. Since 
the first form of the command line is shorter, especially if 
the suffix were change to "CM", the second form is seldomly 
used. 

Command-interpretei — loadable programs must meet the 
following requirements: 

1. The program must load above the resident 
operating system; it must be origined to load 
above hexadecimal location «1FFF. The program 
can access the direct addressing area below 
hexadecimal address $100 (BSCT) during execution; 
however, that area of the memory cannot be loaded 
into. Thus. variables in BSCT cannot be 
initialized during loading. In addition, if a 
program is going to use diskette I/O. none of the 
locations below address «20 can be used by the 
program for its own variables. 

2. The program must load within the range of 
contiguous memory that was established during 
MDOS initialization. Such programs require an 
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additional eight bytes of memory beyond their 

highest loaded address to allow room for a stack 

when the debug monitor is entered. These eight 

bytes must be uiithin the contiguous memory block 
known to MDOS. 

If either of these criteria is not met* the standard error 
message uill be displayed indicating that the program has an 
invalid load address. 

After the program is loaded {without any options), the 
debug monitor will, be entered (as seen by the input prompt of 
the resident monitor). The pseudo registers of the debug 
monitor will have been initialized by the LOAD command to the 
following values: 

Pseudo register Contents 



p Starting execution address 

X Lowest address loaded into 

S Highest address loaded into (eight 

bytes greater than the highest actual 

program location) 
A. B# C Indeterminate 
Y Indeterminate (MD0S09) 

U=S P1D0S09 only 
DP=0 MDQS09 only 

Normallyj command-interpreter-loadable programs take 
advantage of the fact that the stack pointer is initialized 
to the end of the program area by using that part of memory 
for the actual stack during execution. Such stacks must be a 
minimum of SO (decimal) bytes in size. 

In addition to setting up the pseudo registers, the LOAD 
command will change the MDOS variable ENDUS* (Chapter 24) to 
contain the last address loaded into by the program. This 
allows the program to dynamically allocate additional 
contiguous memory for buffers, etc., via the ". ALUSM" 
function (Chapter 27). 

Caution must be exercised when loading a program and 
entering the debug monitor. If MDOS is to be reinitialized, 
the ABORT or RESTART pushbuttons must first be depressed 
before the debug command "EBOO; G" or "MDOS" is executed. 

IS. 1. 2 Non-command-interpretei — loadable programs 

Programs are not loadable by the MDOS command 
interpreter must be loaded into memory for either testing or 
execution via the LOAD command. Normally/ such programs will 
overlay the resident operating system or will load into areas 
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outside of the contiguous memory known to MDOS. Such 
programs cannot be executed directly via the MDOS command 
interpreter. 

The "V" option will inhibit the memory boundary tests 
explained in the previous section. A program loaded with the 
"V" optioni however. must still meet the following 
requirements: 

1. The program must load above the RAM variables 
required by the diskette controller. That is. 
the program must be assembled to load above 
hexadecimal location *1F, The program can access 
the direct addressing area below hexadecimal 
location *20 during execution; however, that area 
of memory cannot be loaded into. Thus, variables 
in the direct addressing area cannot be 
initialized during loading if their addresses are 
between *0000 and *001F. inclusive. 

2. The program's ending load address, as calculated 
from the parameters in the RIB. must not be 
greater than *FFFF. Specifically, the starting 
load address plus the number of sectors to load 

• minus one (expressed in numbers of bytes), plus 
the number of bytes to load from the last sector 
minus one. must be less than or equal to *FFFF 
(see section 24.2). 

If either of these criteria is not met. the standard error 
messages will be displayed indicating that the program has an 
invalid load address. 

If the program is to be loaded for testing, only the "V" 
option should be specified. Thus, the command line 

LOAD TESTPROGi V 

will cause the debug monitor to be entered after the program 
is loaded from the file TESTPRO<J. LQ from logical unit zero. 
The pseudo registers will contain the following values: 

Pseudo register Contents 



P Starting execution address 

X Lowest address loaded into 

S EXbug stack address 

A. B. C Indeterminate 

Y Indeterminate (MD0S09) 

U=S MD0S09 only 

DP=0 MD0S09 only 

Since the memory boundary check is bypassed with the "V" 
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option/ the program can be assembled to load anguihsre above \ 
location $lFi hotaeYeri no check is made to verify that memory 
exists (uhere the prograoi is loaded. 

Once programs have been testedj they can be executed via 
the LOAD command by specifying the additional option "9", as 
in the following command line: 

LOAD TESTPROG; VG 

The "G" option will bypass entering the debug monitor and 
cause control to be passed directly to the loaded program. 
The stack pointer is still configured as explained above. 

If the "V" option is used (ujith or without the "Q" 
option).. the SWI vector will be restored to its original 
value that points back to the debug monitor. Thus* programs 
loaded with the "V" option cannot use the resident MDOS 
functions. 

la. 1. 3 Programs in the User Memory Map 

By using the "U" option as shown in the following 

command line/ the LOAD command can be used to load a program 

into the User Memory Map of an EXCRciser II system that has 
the dual memory map configured: 

LOAD TESTPROG; U 

If the dual memory map is not configured* an error message 
will be displayed. 

The only requirement placed on programs loading into the 
User Memory Map is that the ending load address not be 
greater than *FFFF. Otherwise/ any memory locations 
(*0O0O— FFFF) can be loaded into; however/ no check is made to 
ensure that memory exists where the program is loaded. If 
the "G" option omitted/ the debug monitor will be entered 
after the program is loaded. The debug monitor will display 
the User Memory Map prompt/ not the Executive Memory Map 
prompt. The pseudo registers will contain the following 
values: 

Pseudo register Contents 



P Starting execution address 

X Lowest address loaded into 

S Highest address loaded into 

Aj B/ C Indeterminate 

Y Indeterminate <MDaS09) 

U=S MD0S09 only 

DP=0 MD0S09 only 
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Caution must be exercised in starting execution of 
programs loaded in this manner. Since the stack pointer 
contains the address of the last loaded program location, use 
of the debug raonitor commands ";P" or ";N" will cause seven 
locations of the program to be destroyed. This may alter 
program data or instructions. It is recommended that the 
stack pointer first be changed via the "; S" command; that the 
"nnnn; G" command be used to initiate execution; or that area 

The LOAD command's "Q" option can be used in addition to 
the "U" option to give control to the program immediately 
after it has been loaded: 

LOAD TESTPROGi UG 

The "M6S00 EXORciser II User's Su4de" should be consulted for 
a complete discussion of the User Memory Map. 

If the "U" option is used (uiith or without the "G" 
option), the SUI vector will be restored to its original 
value that points back to the debug monitor. Thus, programs 
loaded with the "U" option cannot use the resident MDOS 
functions. 

IS. 1. 4 MDOS command line initialization 



The Other Option (<Cstr>) is used uihile testing 
command-interpreter-loadable programs (section 18.1.1). Such 
programs usually obtain parameters via the initial command 
line that activated the program. When testing such programs, 
houjever, the command line buffer will contain the command 
line that invoked the LOAD command. Thus, the (<str>) option 
is used to allow testing of the loaded program as if it had 
been invoited from the command line directly, simulating its 
execution— time environment. The quantity <str> will be 
placed into the MDOS command line buffer. The command line 
buffer pointer, CBUFP$ (Chapter 34), will be adjusted to 
point to a null character which precedes the string (a valid 
terminator for the . PFNAM function; Chapter 27). Any 
displayable characters, except the right parenthesis ")", can 
be included in the string <str>. The string will be 
terminated with a carriage return after it is placed into the 
command line buffer. Thus, the use of the null string "()", 
will cause a single carriage return to be placed into the 
buffer. 

The (<str>) option can be used with any of the Main 
Options; however, it only makes sense when no Main Option is 
used (command-interpreter-loadable programs). 
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IS. 1. 5 Entering the debug monitor 

The LOAD command can be invoked without entering a file 
specification. For example, the command line 

LOAD 

will cause the debug monitor to be entered directly. For 
MDOS, the message 

BKPT ERROR ^^^^ 

P-2131 X-2170 A-OD B-80 G-CO S-227F 
* 

SWI p-2131 X-2170 A-OD B-SO C-CO S-227F 
E* 



will be displayed depending on whether ^^^"9 /_°:^ Jf "J ^f^ 
respectively, is in the system. The actual contents of the 
pseudo registers may differ. 

For MD0S09, the message 

SWI P-2131 U-227F Y-FF34 X-2170 DP-OO A-OD B-BO C-CO 
S-227F 

will be displayed. " 

If the LOAD command is invoked in this way, tf^e^^f* "° 
time Should MDOS be reinitialized via t,e "ESOO.G" or ^MDOS;^ 

command without first depressing -*^- *^J^^f '^^//.^f ^S^J 
pushbuttons on the front panel ot tne EXORciser. If t^.ai-L.mj 
command was entered as shown in the example ^''^^e, MDOS can 
be reentered without reinitialization by using the debug 
monitor command "iP". The LOAD command has configured itself 
so that the "iP" command will cause a normal return to the 
MDOS command interpreter. 

If the "V" option was used without a file name specified 
on the command line, the "iP" command will cause MDOS to 
reinitialize as if an "ESOOi G" or "MDOS" command had been 
Hien to ihe debug monitor. The "V" option has the same 
Infect as using the ABORT or RESTART pushbuttons insofar as 
the SWI vector configuration is concerned. 

The "U" option is invalid with this form of the LOAD 
command. 

The Other Options "9" and "(<str>)" are invalid when the 
LOAD command is invoked without a file name specification on 
the command line. 
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18. 2 Error Messages 



The LOAD command displays error messages from the 

standard error message set; however. since some of these 

messages have special significance to the LOAD command only, 

they are listed here. 

** 07 OPTION CONFLICT 

This error message can be displayed for the 
following reasons: More than one Main Option uias 
specified at the same time; the LOAD command was 
invoked without a file name with the "U" option; 
or the "U" option was used on an EXORciser I 
system or on an EXORciser II system without the 
dual memory map configured. 

Earlier versions of MDOS supported the "P" and 
"M" options which were used as defaults if no 
options were entered. The "P" option had same 
effect as the null Main Option. The "M" option 
had the same effect as the null Other Option. If 
"P" was used with any of the Main Options, or if 
"M" was used with the "G" option. then this 
* message would also be displayed. 

»* 12 INVALID TYPE OF OBJECT FILE 

This error message is displayed if the file 
specified on the command line was not a 
memory-image file. In odd cases, this message is 
also be displayed if the Retrieval Information 
Block of the file has been damaged. If this is 
the suspected cause. then the REPAIR command 
(Chapter 22) should be run to verify that the RIB 
is in error. 
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** 13 INVALID LOAD ADDRESS 

If the LOAD command was invoked with the null 
Main option, the program cannot be loaded for one 
of the folloujing reasons: 

1 It loads over the resident operating 
system. That is, it loads &«*ow 
hexadecimal location $2000. 

2. It loads beyond the range of contiguous 
memory knoum to MDOS (established at 
initialization time). 

If the LOAD command u,as invoked uiith the Main 
_ . . ...... j.v_ -.~-„-..=«i rannot he loadeu uecause 

Ootion V , ««!= ,,.W3.— .. 

it loads belou, hexadecimal location S20, or the 
program's ending load address is greater than 
$FFFF. 

If the LOAD command mas invoked uiith the Main 
Option "U", ending load address is greater than 
«FFFF. 

'in the cases u.here the ending load address 

i"ceeds SFFFF, the RIB of the file has been 

invalidly created. Usually, this occurs (i^hen a 

;;:;ram 'loads into the highest memory location 

(*FFFF) but does not start loading at an address 

that is a multiple of eight. Since the only 

information available to the LOAD command is the 

starting load address and the program s size (a 

multiple of eight bytes), the ending load address 

^au exr^ed $FFFF (diskette controller forces the 

multiple of eight byte criterion). Then, tne 

program should be re-assembled °^-«-^ ^"^;^5°f^f^ 

so that the starting load address is %J"^*JP^ 

of eight If this is not the case, the REPAIR 

command (Chapter 22) should be invoked to check 

for other files that may also be in error. 

»* 30 INVALID EXECUTION ADDRESS 

The the file from uihich a program is to be loaded 
has an invalid RIB uihich must be fixed u,ith 
REPAIR. The starting execution a^^^^^%/^" 
outside of the block of memory that Uiould be 
loaded by the program. 



...y 
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18. 3 Examples 

The following command line: 

LOAD TESTPROG: 1; (FILEl, FILE2i S=1000) 

Dill load the program from the file TESTPROG. LO from logical 
unit ens into memoru. The program must be origined to load 
above' the resident MDOS and below the end of contiguous 
memory. The MDOS command line buffer will be initialized 
with the string 

FILEl; FILE2; S=1000 

to allow the program to be tested as if it had been invoked 
from the command line directly. After the program is loaded, 
control is given to the debug monitor. 

The next example illustrates how user-written programs 
ars executed from diskett-e directly. The program can load 
anywhere in memory except below hexadecimal location $20. 
The program cannot use any of the resident MDOS functions: 

LOAD BLAKJACKj VG 

The next example illustrates how the PROM 'Programmer I 
program can be used for making PROMs of programs that load 
above resident MDOS and the ' area req.uired by the command 
interpreter and LOAD command. It is assumed that the program 
in the file TPROM. LD loads above $2300. Since the contents 
of memory are not destroyed during the initialization 
procedure, MDOS can be reinitialized after loading the 
program TPROM without losing the content of those memory 
locations. Then, the LOAD command is used again to load and 
execute a version of the Prom Programmer I program (origined 
to load at location $20). 

=LOAD TPROM; V 
*EBOO; G 
MDOS 03. 00 
=LOAD PPLOi VG 

The command "ESOO; G" can be validly used since the program in 
the file TPROM. LO was loaded with the "V" option. If no Main 
Options are used, the ABORT or RESTART pushbuttons would have 
to be depressed first. 
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19. MERGE COMMAND 

The MERGE command allows one or more files to be 
concatenated into a neuj -File. This command is uss.ui m 
combining several smaller program files into one large file. 
or in building relocatable libraries to oe used m 
conjunction with the M6800 Linking Loader <RLOAD). 

19. 1 Use 



-TL ^ ».r-r.rtrr -»_,^s«,4 ■! c i n kj n ir a li iiiirh fc h P rOiiOtumQ COmmanu 
1 n e rifcr\>»t. w w 111111=1* w *— -..-—.. — -■■ - - 

line: 
MERGE <name l>t:> Cname 2>. . . . - <name n>:, <dname>C; <op tionsM 

where <name i> (i=l to n) are the names of the files to be 
merged together, <dname> is the name of the destination file, 
and <options> can be one or both of the options listed beloui. 
A maximum of 38 (decimal) file names can be accommodated by 
the MERGE command. 

Option Function 

U Use automatic overwrite if destination 

file already exists on diskette. 

<addr> Use hexadecimal <addr> as starting 
execution address of destination file. 

The <option5> are described in detail in the following 
sections. 

Only <name 1> and <dname> are required. All file name 
specifications on the MERGE command line must contain at 
least a file name. For all <name i>, the default suffix "SA" 
and the default logical unit number zero will be used if none 
are explicitly given. The default suffix and logical unit 
number for <dname> are taken from <name 1>. 

MERGE will perform two different functions depending on 
whether' <dname> is the same as <name 1> or not. If <dname> 
is different from <name 1>, then all of the files specified 
by <name i> will be combined into the destination file 
<dname>. Each of the <name i> files will remain unaffected. 
If <dname> is the same as <name 1>, however, then MERGE will 
append the files specified by <name 2> through <name n> to 
the end of the file <name 1>. In' this case, the file <name 
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1> will be changed. 

The filg names <name 2> through <name n> are optional. 
If they are specified* they must be of the same file format 
and have similar allocation and space compression attributes 
as <name 1>. In addition, their names cannot be the same as 
that of <dname> unless <dname> is the same as <name 1>. If 
file names <name 2> through Cnams n> are not specifitd. the 
MERGE command performs the same function as the COPY command. 
That is. 

MERGE <name 1>. <dname> 

is identical to the command line 

COPY <name ir>.- <dname> 

assuming that <name 1> is not the same as <dname?^. 

Only four types of files can be processed by the HERGE 
command. The files specified by <name i> must have one of 
the following formats; 

File format as File format 
shoun by DIR 




2 
3 

5 



Usei — defined 
Memory— image 
Binary record 
ASCII record 



Memory-image files can be merged together. The file 
<dname>. however, cannot exist in such cases because MERGE 
must ensure that the destination file is allocated contiguous 
space to accommodate the memory-images of all <name i> files. 
If <dname> already exists, MERGE cannot ensure such 
allocation. For all other file formats that <name i> can 
assume, <dname.> can already exist. In such cases inhere 
<dname> is different from <name 1> and already exists in the 
directory (and no "W" option on command line), the message 

<dname> EXISTS. OVERWRITE? 



»V I, 



will be displayed. The operator must respond uiith 

MERGE is to perform the merge operation Any other response 

will terminate the MERGE command and return control to MDOS. 

19. 1. 1 Merging non-memory-image files 



If the files 
user— defined format. 



specified by <name i> are all 
•the binary record format, or the 



record format, then the destination file <dname> ut: 



of the 

ASCII 

1 be a 
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direct concatenation of ail of the source 
example, if five ASCII record files are 
destination file can be represented by: 

Destination File 



* ■• ■? 



ss. 



merged, the 






Pi 1 B 2 




File 5 



start of file 



end of file. 



if 



the 
The 



The same type of concatenation would take place 
file format vuas either user-defined or binary record 
MPRQP rommand can be used in this manner to create one large 
data or source program fiie rrom smsiiei - ■■ - - 
file of relocatable object programs. 

19.1.2 Merging memory-image files 



T ^ * VS » 



memor 

mill 

frtemor 

spann 

occup 

will 

occup 

a fil 

loade 

the c 

are 

b inar 



If a 
y — ima 
be a 
y lo 
ed by 
y ove 
conta 
ies 
e tha 
d in 
omman 
not 
y zer 



11 of the files 
ge format files, t 
memory-image file a 
cations between th 
the <name i> files 
rlapping areas in m 
in the contents of 
those common locati 
t is the memory ima 
to memory in the 
d line. Regions of 
"loaded" into by 
oes. 



specified by <name i> are 

hen the destination file <dname> 

Isoj however, it will span all 

e lowest and the highest address 

If the files to be merged 

emory, then ihe destination file 

the last file to be merged that 

ons. The MERGE command produces 

ge of files 1-n as if they were 

sequence in which they appear on 

memory spanned by <dname> that 

the <name i> files will contain 



For example, if three memory-image files as described in 
the following table were merged together, 



<name. i> 
file 



Lowest 
address 



Highest 
address 



1 

2 
3 



600 
100 
1200 



FFF 
7FF 
13FF 



then the resulting destination file can be represented by: 
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Memory 

Location 



1 





6 





S 

o 





F 
F 
F 



1 

2 





1 

3 

F 
F 



! 222222222222222222222221 1111111 
i 222222222222222222222221 1 1 1 1 1 1 1 
i 222222222222222222222221 1111111 



33333333 ! 
33333333 ! 
33333333 \ 



. . Overlayed <name 1> 
Stafi; O'f ■Cdnaos^ End of -Cdname?. 



The numbers in the body of the rectangle aoove inuiu-.^ 
the data of the respective <name i> file Thus, J^ 
indicates the data of <name 2>, etc. Betuieen locations S600 
and $7FF, the data of <name 2> is seen. It overlayed any 
information put into <dname> by <name 1>. Since none of the 
<name i> files spanned the addresses from SIOOO to ^ IFF, 
inclusive, that part of <dname> is initialized to binary 
zeroes. 

It should be noted that programs from memory-image files 
loaded into memory are always a multiple of eight bytes in 
length. This is a function of the diskette controller. 
Regardless of the actual data of a file, a multiple of eight 
bytes uiill always be loaded. This fact must be kept m mind 
when merging files which span memory locations that ars close 
together. 



Memory-image files have associated with their 
information a starting execution address. If no <opt 
field is specified on the MERGE command line, <dname> 
have the starting execution address of <name 1> assign 
it; however, as can be seen from the above example, 
default execution address can be meaningless. An exp 
execution address can be specified in the <opt 
a one to four digit hexadecimal number. The ad 
within the range of memory addresses spanne 



starting 
field as 
must lie 
<dnaffle>. 



load 
ions> 

will 
ed to 

this 
licit 
ions> 
dress 
d by 



19. 1. 3 Other options 



The "W" option is used to allow the destination file to 
be overwritten if its file name already exists; the 
"OVERWRITE" prompt is not displayed and MERGE performs its 
expected function. If the "W option is not used, the MERGE 
command will prompt the operator before overwriting the 
destination file. The "W" option is not valid if <name 1> is 
a ffl=m«— -image file because the destination file cannot exist 
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in that case. 
19. 2 Messages 

The following messages can be displayed by the MERGE 
command. Not all messages are error messagesi although error 
messages are included in the list. The standard error 
messages that can be displayed by all commands are not listed 
here. 

<name> EXISTS. OVERWRITE? 

The specified file name already exists in the 
directory. The operator is prompted before the 
file is overwritten. A "Y" response will cause 
the jserge tu t<aiie pxaCe. nny Ownsr rssponss wi«« 
cause control be to returned to MDOS. 

** 15 <name> HAS INVALID FILE TYPE 

The file indicated by <name> is not of the proper 
format (i.e./ ASCII record, binary record, 
memory— imagBi or user— defined ) » or the RIB of the 
file is damaged. A memory-image file's RIB is 
considered to be damaged if the number of sectors 
to load is zeroi the number of bytes to load from 
the last sector is zero, or if the ending load 
address is larger than *FFFF. If a damaged RIB 
is suspected/ the REPAIR command (Chapter 22) 
should be invoked to correct the error. 

♦* 16 CONFLICTING FILE TYPES 

The files specified by <name i> have different 
file formats. They must all be the same format. 
Even if the format (ASCII record/ etc. ) is the 
samei the contiguous allocation attribute and the 
space compression attribute must also agree 
between all <name i>. This error can also occur 
if <dname> (not the same as Cname 1>) exists and 
has a different file format than <name 1>. 

*» 33 TOO MANY SOURCE FILES 

More than 38 (decimal) file names were specified 
for <name i>. 

19. 3 Examples 

The following example combines the first four files 
specified on the command line into a new file (the last name 
on the command line). The first four files all have the same 
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attributes. The last name is the name of a new file since 
the OVERWRITE prompt was not displayed. 

MERGE PARTI, PART2: 3. PART3: 1, PART4: 2. BOOK 

The default suffix "SA" was used for each file name. The 
destination file BOOK is created on the default logical unit 
number used for PARTI* unit zero. 

The next example illustrates how a relocatable library 
file can be constructed from various smaller files. The 
library file already exists. It will have the files appended 
to its end. 

MERGE LIB. RO. DSKIO. RO, CNSIO. ROi PLOT. RO. LIB. RO 

The last example illustrates how a patch file can be 
attached to a test program file. A new starting execution 
address is specified as *1F20. 

MERGE TESTPROG. LQ, PATCHl. LO. NEWTEST. LQi 1F20 

The file name NEWTEST. LO must not already exist. Both of the 
other two files must be memory-image in format. 
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^0. NAME COMMAND 

The NAME command allows the names* suffixes and/or 
attributes of a file to be changed in the directory. A 
single file name or a family of file names can be affected. 
The contents of a file remain unchanged. 

20. i Use 

The NAME command is invoked with the following command 
1 ine: 

NAME <name 1> C, <name 2>3 C; <op tions>] 

tjhere <name 1> is the file name specification of an existing 
file» <name 2> is the neuj name the file is to be given, and 
■CQption5> can be one or more of the option letters listed 
beloui. 

Option Function 

D Set delete protection 

U . Set write protection 

X Remove protection 

S Set system attribute 

N Remove system attribute 

The -Coptions> are discussed in detail in the following 
sections. 

20. 1. 1 Changing file names 



If <name 2> is specified on the command line» the NAME 
command will attempt to change the name and/or suffix of 
<naroe 1>. <name 1> must always be specified. The default 
suffix "SA" and the default logical unit number zero are 
supplied if none are explicitly given for <name 1>. 

If only a file name is specified for <name 2>, then only 
<name l>'s file name will be changed; its suffix will remain 
the same. For example, the following command line 
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NAME TESTPROe. BLAKJACK 



V 



ujill change the file name TESTPROG. SA: to the new name 
BLAKJACK. SA. The default suffix and logical unit number were 
applied to <name 1> before performing the name change. 
Likeuisei if only a suffix is supplied for <nam8 2>j then 
<name l>'s file name will not be changed; only its suffix 
leill be affected. Thus, the following command line 

NAME TESTPROe. LX; 1, . EY 

will change the suffix of the file name TESTPRGG. LX on drive 
one to "EY". 

A logical unit number should not be specified for <naffle 
2> since the file <name 1> cannot be moved from one logical 

unit to ano"cner uinen n;s neame as uciMs v... = ..a"»-. .. — ■ -■ - 

logical unit number is specified far <name 2>, it must agree 
uiith the logical unit number of <name 1>. 

When changing file names, the family indicator can be 
used in either the file name portion or in the suffix portion 
of <name l>. The family indicator cannot appear in both 
places. The family indicator can be used to change the names 
or the suffixes of an entire family of file names. For 
example, the command line 

NAME *. ED. . SA / 

would change all file names on drive zero that had the suffix 
"ED'" Cas would be created by the EMCOPY command when it uses 
the default suffix) so that they had the new suffix "SA". 
Similarly, the command line 

NAME TESTPROG. *: 2. BLAKJACl< 

would change all files named TESTPROG (any suffix) on drive 
two to have the new name BLAKJACK. The suffixes would remain 
the same. preserving the identity of source. EXbug-loadab le 
object. and memory-image files as designated by their 
respective suffixes.' 

Regardless of how the NAME command is invoked to change 
a file's name and/or suffix, the new name must not already 
exist in the directory. Similarly, the old name specified by 
<name 1> must exist in the directory. If either one of these 
two conditions is not true, one of the standard error 
messages will be displayed. 

20.1.2 Changing file attributes 

In addition to changing a file's name and/or suffix, the 
NAME command can be used to change a file's attributes. The ^ 
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ui.y. i-ha attributes are to be changed is specified in 
ThI "oft ons>%feld Thus, it is possible to change both a 
. fue's name a;d/or suffix and its attributes .ith the same 
invocation of the NAME command. 

The inherent attributes of a file that define its 
ph.sila! fo^mft on the diskette ^^^^^^uous allocatxon, space 
compression, metnor.-image, etc.? cannot be jl^^^fed. These 
attributes remain u,ith a file from the time it ^^ =;^^^^^ 
l-^ 4.ha t-imp it is deleted; however, the protectiion 
attrib.t.: a^r^he ,,sU. attribute can be changed at an, 
time. 

^r.U ri"oJ,! %i "" <sit delete protection, i". t^.- .<=P^'=;:> 



be 



Totter "S" (set system a-c-cr xuu *-= / « 

ittrtbuteT A maximum of fWe option letters can 
tpec fied at one time. The option letters are processed from 
Te^t to right. For example, if a file u.ith ..rite P^f "^^^^ 
setis to Save only delete protection set, the command line 

NAME TESTPROGi XD 

could be used. If the "X" and "D" options u,ere reversed, the 
file would be unprotected. 

If no <name 2> is specified, then an <o^tians> field 
must be present. In such cases, the family indicator can be 
Tsll for both the file name and the suffix of -"^-^ />^ 
Thus a diskette can have all of its files protected or 
unprotected iith a single invocation of the NAME command. 

20. 2 Error Messages 

The follou,ing error messages can be displayed by the 
NAME command. The standard error "J-^^S^^ ^^^^ "" 
displayed by all commands are not listed here. . 

»* 25 INVALID FILE NAME 

This error message is displayed for the following 
reasons: both <name 1> and <name 2> _ were 
specified on the command line and tne rami.y 
indicator was present in both the file name and 
the suffix portion of <name 1>; both <namel> and 
<name 2> were entered with the family indicator, 
or a device name was used for <name 1> or <name 
2>. 
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20. 3 Examples 

The following command line 

NAME *. »: li X 

uiill remove both delete and write protection from every file 
named in the directory of drive one. 

The next command line shows hou files' names and thair 
attributes can be changed at the same time. 

NAME *. ED. . LX; X 

fnis example ujiii nans ^ i. ± t x xa naitics ui^wn ...ic .,»>>'- ~ . 
change it to "LX"> and remove any protection that may be 
present. 

The last example illustrates houj a user— written program 
can be incorporated as a system command file. 

NAME TEBTPRQG. LO: 3. SURFACE. CM: SD 

This command line changes both file name and suffix. In 
addition* the system attribute and delete protection are set. 
Thus, the program file named SURFACE. CM will now be treated 
as a system file by the DIRi DEL, and DOSGEN programs. 
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21. PATCH COMMAND 

The PATCH command allows changes to be made to 

memory-image files. An object file can be "fixed" due to 

minor bugs or assembly errors without having to re-edit and 

re-assemble its corresponding source file. The "fixes" can 

be entered using M6800 assembly language mnemonics or the 
eq.uivalent hexadecimal operation codes. 

21. 1 Use 






line: 



PATCH <name> 



where <name> is the file specification of a memory-image 
file. The default suffix "LO" and the default logical unit 
number zero mill be supplied if none are explicitly given for 
<name>. One of the standard error messages will be displayed 
if the file <name> does not exist or i-f it is of the wrong 
file format. 

The PATCH command is an interactive program that has its 
own command structure. Once PATCH is running. it will 
display a greatei — than sign <>) as an input prompt to 
indicate that a command roust be entered by the operator. 
Commands exist to assign an offset used as a base address for 
accessing the file, to calculate the relative addresses for 
branches, to dis-assemble opcodes, to search the file for 
eight- or sixteen-bit patterns. to display and change 
locations in the file, and to change the starting execution 
address of the file. 

If the file <name> exists and is of the proper format, 
the PATCH command will display the following: 

nnnn cc 
> 

The "nnnn" is the absolute hexadecimal address of >,iiS ...owes- 
location of the memory— image file and is used as the initial 
offset (section 21.2.2). The "cc" is the hexadecimal content 
of that location. The second line is the PATCH input prompt. 
The following sections describe the various commands that 
comprise the PATCH command set. 
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21.2 PATCH Command Set 



Each command to PATCH must be entered by the operator 
after the input prompt <>) is displayed on the system 
console. Like all MDOS input* ail commands must be 
terminated by a carriage return. In the following command 
descriptions these symbols are used: 

Symbol Meaning 



m* n Both "m" and "n" are one to four digit 
hexadecimal numbers. 

c "c" is a one or two digit hexadecimal 
number. 

a "a" is an ASCII character. 

<str> "<str>" is a string of elements separated 

by commas. Each element can be a "c" or 

a group of "a"s enclosed in double 
quotes. 

i "i" is a valid M6a00 assembly language 
mnemonic (M6809 assembly language 
mnemonic, if using MDaS09). 

The period symbol represents the current 
position within the file <naffle>. It 
takes on the value of the current 
absolute address minus the current 

offset. 

» The asterisk represents the assembler 
location counter when used in the operand 
field of instructions. 

<cr> "<cr>" is a carriage return. 

21. 2. 1 Quit — Q 



The Q command is used to terminate PATCH and return 
control to MDOS. The format of the Q command is simply the 
letter "Q". Any changes to the file which are still in 
memory will be written into the file before PATCH is 
terminated. 
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21.2.2 Set/display offset — 

The command is used to display and/or change the value 
of the current offset. The offset is used as a base address 
to which the locati4ten parameters of the other PATCH commands 
are added to arrive at an absolute address within the file. 
The forjnat of the command is 

CmC/ n:30 

If the parameters "m" and "n" are not specified, the O 
command will display the current value of the offset. For 
examp le^ 

>0 

If either of the parameters "m" or "n" are specified, 
the current value of the offset will be changed to either the 
single value "m",- if only "m" is specified, or to the value 
"ffl plus n", if both parameters are present. The following 
sequence of commands illustrates both forms of the O command: 

>A01F0 

>0 

0FFSET=A01F 

>1234, 56780 

>0 

0FFSET=6SAC 

21.2.3 Display single location 



The command to display the contents of a single location 
within the file has the following format 

CroC, n33<cr> 

If both "m" and "n" are omitted, only a single carriage 
return is entered. This form of the command will cause the 
next sequential location of the file to be displayed. Since 
PATCH initializes the current location to the first location 
of the file when first invoked* the carriage return by itself 
can be used to step through the file showing a byte at a 
time, as in the following example. 
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=PATCH TESTPROG 

2000 30 
> 

2001 32 
> 

2002 30 
> 

2003 30 
> 

2004 OE 



If either "m" or "n" are entered prior to the carriage 

contents o-P location "m plus the current offset" or the 
contents of location "m plus n". For example. 

=PATCH TESTPROG 

2000 30 

>0 

OFF5ET=2000 

>10 

2010 2D 

>100 

2100 OD 

>200, 2000 

2200 A6 

>1000, lOOO 

2000 30 

X3 



21.2.4 Display lowest address — L 



The L command is used to change the current location to 
the lowest address of the file. The contents of the lowest 
address will also be displayed. The format of the L command 
is simply the letter "L". 

Initially, when the PATCH command is started, the lowest 
address is shown automatically. The L command can be used to 
return to this point of the file at any time. Locations at 
addresses numerically less than "L" cannot be accessed since 
they do not correspond to any diskette space allocated to the 
file. 



21.2.5 Display highest address — H 



The H command is used to change the current location to 
the highest address of the file. The contents of the highest 
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address usill also be displayed. Ths format cf the H coaanand 
is simply the letter "H". Locations at addresses numerically 
greater than "H" cannot be accessed since they do not 
correspond to any diskette space allocated to the file. 

21. 2. 6 Calculate relative address — R 



The R command is used to calculate the relative address 
between any two locations in the file. The format of the R 
command is 

mZ, nlR 

The R command mill calculate the relative address between the 
current location in the file and the address "m plus the 
current offset" or the address "m plus n". The following 

eA^mpj-B i i J. u 3 (<■ la t. tr 3 Kuc wac wi >»•.= n i. w >a>i..<. - >. -- ^-... 

that the locations used in the example are the second bytes 
of branch instructions. 

=PATCH LOG. CM 

8200 00 

>BA 

82BA 05 

>COR 

REL ADDR=0005 

>119 

8319 F9 

>113R 

REL ADDR=FFF9 

>Q 



The first relative address is in the forward direction. The 
second relative address is in the backward direction. The 
relative address is shown as a sixteen-bit number* even 
though only eight bits are required for the operand of the 
M6800 branch instructions. 



21.2.7 Dis-assemble operation code — I 



The I command is used to convert a one-byte operation 
code into its equivalent M6800 or M6809 assembly language 
mnemonic. The format of the I command is 



where "c" is the one-byte hexadecimal operation code for 
MDOS. For MD0S09, "c" may be a one- or two-byte hexadecimal 
operation code. If two bytes» the first byte must be 00, 10> 
or 11. The contents of the file are not affected by the I 
command. For MDOS, the format of the assembly language 
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mnemonic that is displayed is the follouiing: 

MMM CCA or B3 C#3<HH or HHHH or RR> C,X33 

For MD0S09, the format of the assembly language mnemonic that 
is displayed is the following: 

MMM CCA or B3 C#3<HH or HHHH or RR or RRRR or RL or R. R> 

L>RlJ 

The symbols take on the following meanings: 
Symbol Meaning 



MMM The three-character mnemonic or base 
mnemonic. 

A or B The accumulator specification for 
accumulator instruction types. 

# The immediate addressing mode operand 
qualifier (cannot appear concurrently 
with ",X". "RR", "RRRR". "RL", "R,R", or 
" I R " > . 



HH 
HHHH 

RR 

, X 
RRRR 

RL 

R, R 
,R 



A one-byte hexadecimal operand. 

A two-byte hexadecimal operand. 

A one-byte hexadecimal operand indicating 
relative addressing mode (cannot appear 
concurrently with "#", ", X", or ",R">. 

The indexed addressing mode operand 
qualifier (cannot appear concurrently 
with "#", "HHHH", or "RR"). 

A two-byte hexadecimal operand indicating 
relative addressing mode (cannot appear 
concurrently with "#" or ",R"). 

The operand is a register list (cannot 
appear concurrently with "#" or ",R"). 

The operand is a register pair (cannot 
appear concurrently with "#" or ",R"). 

The indexed addressing mode operand 
qualifier (cannot apftear concurrently 
with "«", "RR". or "RRRR"). 



The following example for the M6S00 illustrates the 
different types of displays that can be generated by the I 



,y 
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command. 



=PATCH TESTPROG 

2000 30 

>aBI 

ADDA »HH 

>9BI 

ADDA HH 

>ABI 

ADDA HH, X 

>BBI 

ADDA HHHH 

>53I 

COMB 

>8DI 

BSR RR 

-t ^ »% T 

JSR HHHH 
>29I 
BVS RR 
>Q 



21. 2. 8 Set search mask and pattern — M 



The M command is used to initialize a sixteen-bit search 
pattern and a sixteen-bit search mask for subseq.uent byte or 
word searches (sections 21.2.9-21.2.12). The format of the M 
command is 

Cm:C, nDM 

where "m"" is the search pattern and "n" is the search mask. 
Initially, both the search pattern and the search mask are 
set to zero. The M command can be used to set both pattern 
and mask or to set either independently of the other. For 
example, 

E5E5M 

will set only the search pattern to the hexadecimal number 
*E5E5. The search mask is unaffected; however, the command 

, FFFFM 

will set only the search mask to the hexadecimal number 
$FFFF. The search pattern is unaffected. The command 

E5E5. FFFFM 

will set both the search pattern and the search mask. 
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21. 2. 9 Search for byte — S 



The S command is used to search 
eight-bit pattern. The format of the 



the file for 
S command is 



a specific 



m< nS 



luher 
of 

curr 
must 

Only 

the 

will 

the 

the 

offs 

file 



e "m" and 
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ent value 
have be 
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search 
display 
search 
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meets th 
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ses a 
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the M 
es of 
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h is i 
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ting and 
re both 
ttern to 
command < 
the sear 
S command 
ain patte 
s of the 
us offse 
ndicated 



ending addresses 
modified by the 
be searched for 
section 21. 2. S). 
ch pattern and 
The S Command 
rns which meet 

file incliJueu in 

t" to "n plus 
if a byte in the 



contents of address ?< search mask = search pattern 



uihere the "%t" indicates the logical "and" function, 
following example illustrates the use of the S command: 

=PATCH TESTPROG 
8200 30 
>OOeE. FFFFM 
>0, 1D7S 
S2A7 EE 
a2AD EE 
S2AF EE 
><3 



The 



21. 2. 10 Search for word — W 



The W command is similar to the 
instead of searching for only a single bytei a double byte 
or wordi is searched for. 



S command; however; 
e bi 
The format of the W command is 

tttt nW 



The address range searched with the W command is from "m plus 
offset" to "n plus one plus offset"; inclusive. Thus, "n" 
cannot be the highest address of the file* since "n+1" would 
be an illegal address. Otherwise; the W command functions 
identically to the S command. 
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21.2. 11 Search for non-matchitig byte -- N 



The N command is similar in format and function to the S 
command; however/ instead of displaying all bytes that meet 
the search criteria/ all bytes that do not meet the search 
criteria are shown. This makes it easy to search through a 
buffer of ail leroes/ for example/ to find any non-zero 
locations. 

21.2. 12 Search for non-matching word — X 



The X command is similar in format and function to the W 
command; however/ instead of displaying all double bytes that 
meet the search criteria/ all double bytes that do not meet 
the search criteria are shown. 

21. 2. 13 Display range of locations — P 



The P command prints the contents of a range of 
locations on the system console. The format of the P command 
is 

mi nP 

where locations "m plus offset" through "n plus offset", 
inclusive/ are the locations to be shown. The format of the 
display is illustrated in the following example: 

=PATCH TESTPROG 
8200 30 
>95, DOP 

8290 0090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

S2A0 OOAO 00 00 00 00 00 3F 32 EE 04 FF 80 04 30 EE 00 EE ?2 0. . . 

S2B0 OOBO 06 FF SO 06 CE SO 00 3F 05 24 05 5F 3F 20 3F lA ?. «. _? ?. 

S2C0 OOCO 3F 33 3F 05 24 03 7E 03 D3 7E 04 32 30 31 30 30 ?3?. * 20100 

S2D0 OODO 00 OO 00 00 43 4F 4E 53 4F 4C 45 20 4C 4F 47 20 . . . . CONSOLE LOG 
>Q 

The contents of the locations are shown in both 
hexadecimal and the equivalent displayable ASCII. If a 
location contains a non-d isp layab le character/ it is shown as 
a period <. ). The first foui — digit number contains the 
absolute address while the second four-digit number contains 
the relative address of the locations (relative to the 
beginning of the file). Even though the starting location 
requested was $95/ the displayed locations start at location 
$90. A full sixteen locations are displayed for each linei 
regardless of the requested starting and ending points of the 
range. 
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21.2.14 Set/display execution address — -^ 

The command is used to display and/or change the value 
of the file's starting execution address. The format of the 
6 command is 

CfflC*n33S 

If the parameters "m" and "n" are not specified, the G 
command mill display the current value of the execution 
address. The follouiing example illustrates this use of the S 
command : 

=PATCH TESTPRQG 

8200 30 

>G 

EXEC ADR=8259 

><a 

If either of the parameters "m" or "n" are specified, 
the current value of the execution address will be changed to 
"m plus offset" or "m plus n". The execution address must be 
uithin the range of addresses spanned by the file (between 
addresses shown with L and H commands). The following 
example shows how the G command is used to change the 
starting execution address: 

=PATCH TESTPRQG 

3200 30 

>G 

EXEC ADR=S259 

>2G 

>G 

EXEC ADR=8202 

>Q 

21. 2. 15 Change locations 

Two commands exist that will open a specified location 

within the file and allow the contents of that and subsequent 

locations to be examined or changed. The format of these 
commands is 

mC,n]-C/ or \>i:<str>3 

where the slash (/) and backslash (\) characters BV^i used to 
distinguish between the two commands. Both commands will 
open the specified location ( "m plus offset" or "m plus n"). 
The slash command will set the "increment" mode. The 
backslash command will set the "decrement" mode. The -^ 
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parameter <str> contains any changes that are to be applied 
to the specified locations. If the "increment" mode is set 
(slash command); any changes specified in <str> uiill be 
applied to the opened location and each subsequent higher 
location! one increment being applied for each element of the 
string. If the "decrement" mode is set (backslash command)* 
any changes specified in <str> will be applied to the opened 
location and each preceding lower location/ one decrement 
being applied far each element of the string. If any of the 
elements of the string are null» an increment (or decrement) 
luill still be applied for those elements. Thus. if the 
entire string is null (one null element); one increment (or 
decrement) will be applied. The "increment" or "decrement" 
modes will remain in effect until changed by another slash, 
backslash, or parenthesis command (section 21.2. 16). 

Tko «*■»»■! T»r> ''s'tr^ can contain either hexadecimal glgments 
or ASCII string elements, in any combination. For example, 
the command 

1500. 0/AA, 1. 2E. "AABBCC" 

will change the following locations to the indicated value-s: 



Absolute 


New value 


Address 




1500 


*AA 


1501 


*01 


1502 


$2E 


1503 


*41 


1504 


$41 


1505 


*42 


1506 


*42 


1507 


*43 


1508 


*43 



If the backslash command had been used instead. locations 
$14FF, . *14FE. etc. . would have received the values $01. *2E. 
etc. 

An element of the string can be null (indicated by 
successive commas). Null elements will not affect the 
location that corresponds to that part of the string. 

If an error is encountered in the string of elements 
<str>. the entire command will be ignored and no changes will 
be applied. An error message is printed to indicate that the 
command was not parameterized properly. 
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21. 2. 16 Instruction mnemonic decode mode 



The instruction mnemonic decode mode is similar to the 
slash command explained above. Instead of using a slash, 
however, the open— parenthesis character <() is used. This 
command allows changes to be applied to a series of locations 
in the file using M6S00 or M6809 assembly language mnemonics 
instead of the hexadecimal operation codes. The format of 
th e c omiaan d is 

mC. n3{CiDC)3 

where "m" and "n" specify the starting location (either "m 
plus offset" or "m plus n"), the open-parenthesis character 
signifies the start of the instructian (nnemonic decade mode; 
"i" can be any valid M6a00 assembly language mnemonic (M6SO*? 
assembly language mnemonic for MD0SO9); and the 
close— parenthesis character indicates the end of the 
instruction decode mode. Since the close— parenthesis is 
optional* the user can remain in the instruction mnemonic 
decade mode to enter several lines of instructions until a 
close-parenthesis character is entered. 

Once the open-parenthesis command has been issued. all 
other PATCH commands ars invalid until the close-parenthesis 
command is issued* or until an error is encountered. 

The format of the commands following the 
open-parenthesis command is shown below: 

<blanks> ) <any> <ct> 

or 

<blanl{s> <apcode> C<blani<s> <operand>] C<any> ) <any>3 <ct'> 

The syntactic elements ars described as follows: 



^ 
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Element Meaning 



<blanks> Any number of spaces/- including zero. 

<any> Any character besides a carriage 
return or a closs-parenthasis. 

<cr> Carriage return. 

<opcode> Any valid assembly language mnemonic 
as specified in the 
"P16800/M6S01/M6805/M6S09 Macro 
Assemblers Reference Manual"; no 
space is allowed betueen the mnemonic 
and the accumulator designator (e.g. ? 
LDAA is validj LDA A is not). 

<operand> Only valid if the instruction 

requires an operand. If no operand 

is required* the <operand> is treated 
as <any>. 

The <operand> field* uihen required* has the following 
format: 

D#]<arg>C<+ or -><arg>] 

or 

C<arg>C<+ or -><arg>3, 3X 

where the "#" indicates immediate addressing mode and ".X" 
indicates the indexed addressing mode. The "+" or "-" allows 
simple expressions to be used in the operand field. Each of 
the arguments <arg> can be one of the following kinds of 
elements: 
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Element 



Meaning 



'A A one-character ASCII literal. 

$HHHH A one to four digit hexadecimal 
number. 

DD. .0 A decidual number^ any number of 
digits in length; only the least 
significant 8 or 16 bits o-f the 
converted number will be used. 

y.BB. . . B A binary number, any number of digits 

in length; only the least significant 
8 or 16 bits of the converted number 



The value of 



;he 



currsm 



location 



counter (identical 
M6a00 assembler). 



to the "*" used by 



The value of the current offset. 

For MD0S09, the <:operand> field is expanded to allow 
register , 1 ists. "indirect, auto— increment, auto-decrement, and 
forced direct/extended. PATCH automatically generates direct 
mode instructions only when the most significant byte of the 
expression is zero. In all other cases, the direct mode must 
be forced by the user. Reference "ri6a00/M6801/M6805/M6809 
Macro Assemblers Manual." 

This format allows the operator to enter assembly 
language mnemonics uiith comments after the operand field for 
documenting the patch. The instruction mnemonic decode mode 
automatically puts the PATCH command into the "increment" 
mode. 

As long as a close-parenthesis character is not 
encountered, PATCH will remain in the instruction mnemonic 
decode mode. A different input prompt is displayed to 
distinguish the two different PATCH input modes; the normal 
input prompt <>) is replaced the by the instruction mnemonic 
decode mode prompt (=>). 

The following M6a00 example illustrates how the 
instruction mnemonic decode mode is used to insert a patch 
into a file: 
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Line Console Display 



01 =PATCH TESTPRDG 

02 S200 30 

03 >0 

04 0FFSET=S200 

05 >F7 

06 S2F7 CE 

07 >. (JMP 53317 GO TO THE PATCH AREA OF PROGRAM) 

08 >8317, OCLDX #a+*A THE LDX OVERLAYED BY THE JMP 

09 =>STX 0+*D2 

10 =>SWI THIS IS A SYSTEM FUNCTION CALL) 

11 = /ID 

12 . <BEQ *+5 IF NO ERRORS/ CONTINUE 

13 =>JMP 0+$ll3 GQ PRQC-EBS ERROR 

14 =>LDX X PICK UP THE POINTER 

15 =>LDAA 0, X GET A CHARACTER 

16 =>CMPA #'1 IS IT UNIT 1? 

17 =>BNE #-10 GO PROCESS ERROR 

IS =>JMP $a2FD RETURN TO MAIN CODE 

19 =>) 

20 >Q 

21 = . 

In the above example, line 03 was used to display the 
value of the current offset. Line 05 was used to display the 
contents of location *F7i relative to the beginning of the 
file. Line 07 was used to enter the instruction mnemonic 
decode mode to modify the current location (offset + *F7). 
Three locations tuere changed as a result of entering line 07. 
Line 08 was used to reenter the instruction mnemonic decode 
mode; however. this time absolute location S8317 was the 
address where a patch was to be placed. Line 11 was used to 
insert a hexadecimal constant into the location following the 
previously entered SWI instruction. Line 12 was used to 
return to the instruction mnemonic decode mode at the 
location following the hexadecimal constant inserted using 
line 11. Line 19 was used to finally exit the instruction 
mnemonic decode mode. Line 20 was used to exit the PATCH 
command and return control to MDOS. Comments were used 
throughout the instruction mnemonic decode mode to document 
what the patch does. 

21.3 Special Considerations 

The period symbol (. ) can be used with any PATCH command 
that requires an address as an argument. The value 
associated with the period symbol is the absolute address of 
the current location minus the value of the current offset. 
Since the offset is automatically added to most of the 
command parameters; the resulting value for the period symbol 
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Special Censidarstions 



ill 



ill be the absolute address of the current location. 



For gxafljpls. the following uses of the period can save 
time and eliminate remembering the address of the current 
location: 

Command Function 



. i nO Sets the offset to the current location 
if "n" is the value of the offset before 
the command is entered. 

. Kcvy Displays the contents and the address of- 
the current location. 

. /<str> Opens the current location and applies 
the changes from the string <str>. It is 
not necessary for the operator to count 



. I nS 



m. . P 



the number of 
next command is 
Long strings 
initially using 
change command, 
use ". /". 
backslash 



elements in <5tr> if the 

to apply more changes. 

avs usually ch-anged by 

the "m, n/" form of the 

Then* subsequent changes 

The same holds true for the 

and open— parenthes i s commands 



used with the period symbol. 

Search from the current location to 
address "n plus offset". 



the 



Display locations "m plus offset" to the 
current location. 



21. 4 Error Messages 

The following messages can be displayed by the PATCH 
command. The standard error messages that can be displayed 
by all commands are not listed here. 



WHAT? 



The coflwnand issued in response to the PATCH input 
prompt C>) was not recognized. A neui input 
prompt is displayed. 



SYNTAX ERROR 



The command issued in response to the PATCH input 
prompt (>) was recognizedi however/ it was 
parameterized illegally. A new input prompt is 
displayed. The command has not been processed. 
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ILLESAL ADDRESS 

An address was specified which referenced a 
location that was outside of the range of 
addresses spanned by the file. Only addresses 
between the lowest (L command) and the highest 
address <H command) can be referenced by PATCH. 
If new program area is to be allocated for 
additional patch space- a merge process/ 
reassembly process, or link/load process must be 
used to create the new space. 

ILLEGAL OP CODE 

The instruction mnemonic decoder did not 
recognize a valid M6S0O assembly language 
mnemonic. The instruction mnemonic decode mode 
' s terminated. The current instruction was not 
used to change the file. This error can also 
occur if an invalid M6300 operation code is given 
as the operand of the "I" command. 

ILLEGAL OPERAND 

An illegal operand was used in the operand field 
of the instruction. The instruction mnemonic 
decode mode is terminated. The current 
instruction was not used to change the file. 

INITIALIZATION ERROR 

This error indicates some sort of internal system 
malfunction. Errors of this type indicate a 
hardware failure or damaged program files on the 
diskette. 
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22. REPAIR COMMAND 

The REPAIR command allows the user to check and repair a 
malfunctioning or a non-functioning MDOS diskette. Errors 
in the system tables can be found, identified, and corrected 
with this command. Since MDOS performance is directly 
related to the correctness of these system tables, the REPAIR 
command is a useful diagnostic utility. The REPAIR command 
works with either single-sided or double-sided MDOS 
diskettes. 

22. 1 Use 



The REPAIR command is invoked with the following command 
line: 

REPAIR C:<unit>3 

where <unit> is the logical unit number on which a diskette 
that is to be "repaired" resides. If no <unit> is given, 
logical unit number zero will be used as a default. 

The REPAIR command runs through five different phases: 

1. ID , LCAT, CAT, and Bootblock sector check phase, 

2. Directory sector check phase, 

3. Retrieval Information Block check phase, 

4. CAT regeneration phase, and 

5. CAT replacement phase. 

Each of the different phases is described in detail in the 
following sections. 

REPAIR progresses from each phase to the next carrying 
along information that was obtained during a prior phase. If 
errors aTs discovered, the operator will be notified via the 
system console. If REPAIR can fix the error, the operator 
will also be asked if the error should be corrected on the 
diskette. Thus, the operator has complete control over any 
changes that are made to the diskette. The operator can 
suppress any action that may be suggested by the REPAIR 
command as the means for correcting an error. 

The amount of knowledge about the MDOS tables that is 
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required by 
of actual 
information 
tables. 



the operator depends upon tiuo things: the amount 

damage on the diskette and the amount of 

the operator wants to recover from the damaged 



If the operator merely permits REPAIR to perform every 
suggested action to correct every error> then the resulting 
diskette is guaranteed to have evvor free system tables. In 
this case, the amount of systems knowledge required is 
insignificant. 

On the other hand, if the operator takes notes during 
the REPAIR command on . mhat tables are damaged, and if the 
operator does not choose to delete those files that are 
invalid, then a great deal about the the MDOS file structure 

ana aysxiem (/du.ie3 inu3<» «<! nnwwn -w ■>.«.—..— •.—-- — - 

Chapter 24 describes the system structure in detail. It is 
required reading for a complete understanding of all the 
functions and the errors that the REPAIR command can perform 
and detect. 

The REPAIR command must be invoked from a working MDOS 



diskette. 



Thus, 



a 



given diskette cannot be 



used for 

initialization, it must be placed into drives one, two, or 
three, and another ujorking diskette <of the same MDOS version 
as the dammaged diskette) placed into drive zero before the 
REPAIR command can be used. 



REPAIR does not attempt to find errors 
files. It only attempts to find errors within 
tab les. 



within data 
the system 



It 
reasons: 

1. 



2. 



is suggested that REPAIR be used for the following 



As a regular diskette checking utility. It never 
hurts to run REPAIR as a preventative maintenance 
tool to catch errors as they may be developing, 
before serious malfunctions are noticed. If 
nothing is wrong with a diskette, no operator 
interaction is required. REPAIR will simply 
return to MDOS after having displayed some 
monitoring information. 

If strange things start happening or if system 
g^^nj, wjggsanoe are displayed without apparent 
reason. If files or records within files 
disappear or get scrambled, the system tables may 
have been damaged. 



3. If MDOS will not run at all. 
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4. After the ABORT or RESTART pushbuttons iuere 
depressed to stop the system while diskette 
transfers were in progress. 

5. After a power failure occurred while diskette 
transfers were in progress. Power failures 
include those caused by inadvertently switching 
off the EXORciser or EXORdisk II as well as those 
that affect an entire installation. 

6. After a diskette has had its system tables 
repaired manually with the DUMP command. This 
ensures that the tables were corrected properly. 

22.2 ID* LCATi CAT, Bootblock Sector Check 

readability. If an error occurs during the read attempt* 
REPAIR will display the following: 

**PROM I /a ERR0R-STATUS=31 AT 2C4C ON DRIVE 1-PSN 0000 

ID SECTOR READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The actual error status, address, and drive number of the 
first line will vary depending on the type of read error that 
was detected, the version of REPAIR being used, and the drive 
in which the diskette resides. The same is true for all of 
the PROM I/O error messages given in the examples- of this 
chapter. A response of either "N" or "Y" must be made by the 
operator. The "N" response will cause the message 

ID SECTOR CANNOT BE CHECKED 

to be displayed. Since the other system tables could still 
be accessed, REPAIR will continue. If a "Y" response is 
given, the ID sector will be re-written in an attempt to 
clear the error. If an error develops during the write, the 
ID sector is considered unfixable; however, in this case, the 
other system tables could still be accessed, so REPAIR will 
continue. 

If the ID sector can be read initially without error, or 
if the ID sector can be rewritten without error, the contents 
of the ID sector will be displayed as follows: 

DISK ID: MD0S0300 

VERSION: 03 

REVISION: 00 

DATE: 072578 

USER: SYS DEVELOPMENT DISK 

Each field within the ID sector is checked by the REPAIR 
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command. The follotuing table shows what tests are made for 
the respective fields: 



Field 



Test Performed 



DISK ID 

VERSION 

REVISION 

DATE 

USER 

Remainder 



MDOS file name format 

Same as MDOS. SY 

Same as MDOS. SY 

ASCII numeric 

Displayable ASCII 

Binary zero. excluding 

address arsa 



MDOS RIB 



If the fields in the ID sec" 



;or 



fail to meet the above 



criteria* the field's name will be displayed as a prompt to 
the operator to enter a correct value. If only a canisgs 
return is entered in response to such a prompt, the ID sector 
field will not be changed. Otherwise, the entered field will 
be checked for correctness and then stored into the ID 
sector. 

The version and revision numbers in the ID sector are 
compared against those of the resident operating system file 
on diskette. If the numbers are not identical. REPAIR will 
use the version/revision numbers from the MDOS file since the 
diskette cannot be initialized if they are not the same. The 
message: 

VERSION AND REVISION NUMBERS IN ID SECTOR AND RESIDENT MDOS 

FILE ARE DIFFERENT 
THE NUMBERS IN THE ID SECTOR ARE CHANGED TO: vv. rr 



and "rr' 



are 



to indicate the correction. The numbers "vv' 
the version and revision numbers of the resident operating 
system file, respectively. The operator has no control over 
what the version/revision numbers are in the ID sector. 
Thus. those two fields cannot be supplied by the operator. 
In the event that a diskette controller error occurs when 
trying to read the correct vversion/revision numbers from the 
MDOS file, the message 

**PROM I/O ERR0R-STATUS=31 AT 2EBA ON DRIVE 1-PSN 0019 
RESIDENT MDOS CANNOT BE LOADED — SECTOR READ ERROR 

will be displayed. The diskette being repaired cannot be 
used in drive zero since the operating system cannot be readi 
however, REPAIR will continue to check the remaining system 
tables. 



If the 
the message 



unused area of the ID sector has been damaged^ 



ID UNUSED AREA NOT ZERO. ZERO IT? 
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The operator must respond uiith either a "Y" or an "N". The 
"Y" response will cause the ID sector's unused area to be 
filled Sisith binary zeroes* as it is supposed to be. The "N" 
response mill cause REPAIR to leave the ID sector alone. 

After the ID sector has been checked, REPAIR will 

examine the Lockout Cluster Allocation Table (LCAT) for 

readability. If the LCAT sector cannot be read, REPAIR will 
display the folloujing messages: 

**PROM I/O ERR0R-STATUS=31 AT 2ESA ON DRIVE 1-FSN 0002 

LOCKOUT C. A. T. READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The operator must respond with either a "Y" or "N" to the 
last question. If an "N" is entered, REPAIR cannot continue 
to check other system tables since subsequent chec-mg is 
based on the validity of the LCAT. Thus, the message 

DISK IS NOT FIX ABLE 

is displayed and control returned to MDOS. If a "Y" response 
is given, REPAIR will attempt to rewrite the LCAT sector. If 
an error develops during the write, the sector will be 
considered unfixable (as will the diskette). The message 
shown above will be displayed and MDOS given control. 

If the LCAT sedtor is readable, or i-f rewriting the 

sector clears the error, REPAIR will proceed to check the 

contents of the LCAT. The LCAT must show that the diskette's 

system tables in the first cylinder are locked out 
(unavailable for allocation by a file), and all regions of 

the diskette that correspond to non-physical locations 

(beyond the highest physical sector number) must be locked 
out. 

If either of these two criteria is not satisfied, the 
LCAT will be considered destroyed. REPAIR will display the 
message 

LOCKOUT C. A. T. IN ERROR - RECONSTRUCT? 

and await a response from the operator. An "N" response will 
make the LCAT unfixable. REPAIR will display a message to 
that effect and return to MDOS. A "Y" response will cause a 
new LCAT to be rebuilt by REPAIR. In order to build a new 
LCAT, the entire diskette is read in an attempt to find any 
deleted data marks. The deleted data marks signify bad 
clusters found by the D0S(5EN surface test (Chapter 10). All 
clusters containing deleted data marks will be locked out 
again automatically by this process. In addition, the 
operator can lock out an additional area of the diskette (for 
the same reasons as specified in Chapter 10). After the 
diskette's surface has been completely read, REPAIR will 
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display the message 

WHICH SECTOR RANGE IS TO BE LOCKED OUT? 

The operator can respond with a carriage return to indicate 

that no additional sectors are to be locked out. Otheriuise, 

the operator can respond with a range of sector numbers 
entered in the format 

i!>mra~nnn 

where "mmm" and "nnn" are hexadecimal numbers of sectors that 
start on a cluster boundary (sector number is evenly 
divisible by four). If an illegal sector number is entered^ 
or if the starting number is greater than the ending number, 

^i._ _i _«« = =o= i.ii 1 1 ho T'edisnlaued until the operator 

enters a valid range or a single carriage return. Only one 
contiguous range of sectors can be locked out. The same 
cautions described in Chapter 10 regarding user-locked^ out 
sectors apply here; however, in this case. since files 
already reside on the disk with allocated space. the locked 
out sectors must not conflict with any files. If a diskette 
did not have user-locked out sectors before, then sectors 
must not be locked out during the REPAIR process since they 
could conflict with sectors already allocated. The REPAIR 
command is not intended to be used for the normal lockout 
procedure; that is the function of the DOSGEN command 
(Chapter 10). If a diskette did have sectors locked out, 
then the identical sectors must be locked out by the operator 
again here. 

After the LCAT has been rebuilt, or if it was good to 
begin with, the Cluster Allocation Table (CAT) will be 
checked. If the CAT sector cannot be read, the following 
message will be displayed: 

**PRaM I/O ERRQR-STATUS=31 AT 2EBA ON DRIVE 1-PSN OOOl 

C. A. T. READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The operator must respond with either a "Y" or an "N" to the 
last (luestion. If an "N" is entered, REPAIR cannot continue 
to check the other system tables since subsequent checking is 
based on the validiy of the CAT. Thus the message, 

DISK IS NOT FIXABLE 

is displayed and control returned to MDOS. If a "Y" response, 
is given, REPAIR will attempt to rewrite the CAT sector. If 
an error develops during the write, the sector will be 
considered unfixable (as will the diskette). The message 
shown above will be displayed and MDOS given control. 

If the CAT sector is readable, or if rewriting the 
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sector cleared the error. REPAIR will proceed to check the 
contents of the CAT. The CAT must show that all parts o* the 
diskette locked out by the LCAT are flagged as allocated (see 
above for LCAT validity criteria). If the CAT contains an 
error at this point, REPAIR mill display the message 

C. A. T. IN ERROR - RECONSTRUCT? 

and await a response from the operator. An "N" response will 
result in an unfixable diskette. REPAIR will show the 
message 

DISK IS hraT FIXABLE 

and return control to MDOS. A "Y" response will cause a new 
CAT to be reconstructed from the information gathered m 
phases 2 through 4. 

After checking the CAT, REPAIR will attempt to read the 
Bootblock sector. If the Bootblock sector cannot be read. 
REPAIR will display the following message: 

**PROM I/O ERRaR-STATUS=31 AT 2EDC ON DRIVE 1-PSN 0017 

BOOT BLOCK SECTOR READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The operator must respond with either a "Y" or "N" to the 
last question. -If an "N" is entered, REPAIR will display the 
message 

BOOT BLOCK SECTOR CANNOT BE CHECKED 

before coTitinuing. Since the Bootblock is not affected by 
other system tables. REPAIR will continue to check the 
remainder of the diskette; however, a diskette with a 
damaged Bootblock sector cannot be used as an MDOS diskette 
in drive zero. If a "Y" is entered, REPAIR will attempt to 
rewrite the sector in an attempt to clear the error. If an 
error develops during the write, the sector is unfixable and 
the diskette can never be used to initialize the system from 
drive zero. 

If the Bootblock sector is readable or if the error is 

cleared by rewriting the sector, REPAIR will verify that the 

sector contains a valid copy of the Bootblock program. If 
the data is in error, the .message 

BOOT BLOCK SECTOR HAS BEEN DESTROYED 
WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

will be displayed. An "N" response wil leave the Bootblock 
sector unchanged. A "Y" response will cause a new Bootblock 
to be written to the diskette. The REPAIR command will then 
begin Phase 2. 
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22.3 Directory Sector Check ' 

Phase 2 of REPAIR deals entirely mth the MDOS directory 
sectors Each of the directory sectors is first checked for 
r!adabilitu If a read error is found, the operator is 
I^formid and given the choice of trying to clear the read 
error via the following display: 

**PROM I/O ERRCR-STATUS=31 AT 2F38 ON DRIVE i-PSN 0013 

DIRECTORY SECTOR READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The actual numbers in the error message uiill depend or, the 
actual sector that is in error. If the operator responas 

with an "N"! or ir i.iib i =wi j. »= r- 

to clear the error, the message 

DISK IS NOT FIXABLE 

0,111 be displayed and control returned to MDOS. Jt ^ 
sectors are all readable. or if the reu.rite attempt 
succeeded, each directory sector is examined again. This 
time, each directory entry u,ithin each sector -is tested . 
against the following criteria. 

• 1 If the first byte of the directory entry is lero 
(unused entry), then the remaining bytes of the 
entry must be zero also. 

2 If the first byte of the directory entry is the 
hexadecimal number $FF (deleted entry), then the 
second byte of the entry must be «FF also. If 
^-he second bute is not $FF, and if the remainder 
of the entry is valid, then the entry is the 
result of an incomplete name change. It was 
probably caused by a pouier failure or interrupt 
(ABORT or RESTART pushbuttons) during the time 
that the old name was deleted and the neui name 
was added to the directory. REPAIR luill allow 
the operator to delete the directory entry 
entirely or to reassign a name to the partially 
deleted entry. The. name assigned must be the 
same as the original one. Otherwise, the name 
will probably be improperly placed m the 
directory (criterion 5). 

3 The physical sector number of the Retrieval 
Information Block must the first sector of a 
cluster, must not be the sector number of one of 
the system tables checked in Phase 1 or 2, and 
must not be greater than the highest valid 



^ 



physical sector number. 
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4. The directory entry's attribute field must have 
the least significant byte (unused) set to zero. 
In addition, the two unused bytes at the end of a 
directory entry must be set to zero. 

5. The calculated hash index for the file name and 
suffix must locate the directory entry where it 
currently resides. An error in the hash i"^®^ 
means that the directory entry is inaccessible. 
Appendix G contains a detailed description of the 
hashing method. 

6. The system file MDOS. SY must have a Retrieval 
Information Block in a specific physical sector. 
In addition; the other files in the family 
MDOS*. SY must be present in the directory. 

If any directory entry fails to meet one of the first 
five criteria, REPAIR will display the entry in error as well 
as a message identifying the problem. The directory entry is 
displayed in the follou/ing format: 

PSN LSN EN NAME SUF RIB ATTR IMU CHEXNAM HEXSUF3 
where the symbols have the following meanings: 
Symbol Meaning 



PSN Directory sector's physical sector number 

LSN Directory sector's logical sector number 

EN Entry number within sector 

NAME File name 

SUF File suffix 

RIB Physical sector number o.f RIB 

ATTR Attributes 

NU Not used portion of directory entry 

HEXNAM File name in hexadecimal 

HEXSUF Suffix in hexadecimal 

All of the fields ars displayed as hexadecimal numbers with 
the exception of the file name and suffix. If 
non-displayable characters appear in either the file s name 
or suffix, they will be shown as percent signs (%). In such 
cases, the hexadecimal forms of the file name and suffix are 
shown to the right of the directory entry. 

In the following examples, the same directory entry is 
that the changes from one to the other can be more 
The first line always shows the directory 
line contains the error message and a 
If a "Y" is entered, the entry will be 
removed from the directory (and later the space associated 
with that directory entry will be deallocated). An N 



used so 
easily detected. 
entry. The second 
prompt to the user. 
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response will leave the directory entry unchanged. 

The following message is shown for directory entries 
that fail to meet criterion 1. Not all bytes of the entry 
^re zero if first byte is zero. 

03 00 00 %INEX .CM 014C 7200 0000 00494E455a202020434D 
DIRECTORY ENTRY IN ERROR. DELEsE? 

The following message is shown for directory entries 
that fail to meet criterion 2. The directory entry is the 
result of an incomplete name change. Instead of asking the 
operator if the file name should be delated. REPAIR allows 
the original name to be reassigned. If no name is entered m 
response to the prompt (carriage return only), the directory 
.ill. ....11 * = .■! r^i^TPT-ian S. so the entry will be redisplayed 
as""in thTabove example. If the original name is supplied, 
the file's directory entry will be recreated m the 
directory. The content of the file is unaffected, however, 
if a name is assigned other than the original, criterion 5 
uiili probably not be satisfied. The directory entry would 
then be displayed again, with the corresponding error 
message. 

03 00 00 7,INE:< .cm 014C 7200 0000 FF494E455B202020434D 
POSSIBLE INCOMPLETE NAME CHANGE 
NEW NAME: 

The following example illustrates a directory entry that 
fails to meet criterion 3. The RIB address- is of the 
directory entry is invalid. In this case, the RIB address is 
a sector that is not on a cluster boundary. 

03 00 00 BINEX .CM 014D 7200 OOOO 
INVALID RIB SECTOR NUMBER. DELETE? 

The next example shows a directory entry that fails to 
meet criterion 4. The directory entry's attribute field has 
a non-zero unused byte. 

03 00 00 BINEX .CM 014C 72FF OOOO 
ILLEGAL ATTRIBUTE OR UNUSED BYTES. DELETE? 

The last example illustrates a directory entry that 
fails to meet criterion 5. The hash index for the file name 
and suffix places the directory entry into a different 
directory sector than the one in which it appears (file s 
original name is BINEX. CM). 

03 00 00 AINEX .CM 014C 7200 OOOO 
. . HASH OR NAME DUPLICATION ERROR. DELETE? 

Criterion 6 does not deal with directory entries in 
general. Rather, the specific names of the system files ars 
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searched for in the directory to ensure they exist. The 
absence of any one of the system files xs noted by the 
display of one of the folloming messages: 

MDOS .SY DOES NOT EXIST 
MDOSER -SY DOES NOT EXIST 
MDOSOVO . SY DOES NOT EXIST 
MDOSOVl . SY DOES NOT EXIST 
MD0S0V2 . SY DOES NOT EXIST 
MD0S0V3 . SY DOES NOT EXIST 
MD0S0V4 . SY DOES NOT EXIST 
MD0S0V5 . SY DOES NOT EXIST 
MD0S0V6 . SY DOES NOT EXIST 

in addition, if the resident operating ^^^f ^, Jj^^^^" J,;]"* 
have a RIB in the proper physical sector, the diskette could 
not be used for system initialization in drive zero. Thus, 
the message 

MDOS. SY DOES NOT START AT SECTOR «1S 

is displayed in such cases. 

Since errors in the directory entries ^^V. ;°*, J^^^^ 
insofar as REPAIR is concerned (they can be if the ^^^^kette 
is to be used for initialization or to run any ^Jirr^/^^' 
Phase 3 is started after these checks have been completed. 

22.4 Retrieval Information Block Check 

Phase 3 of REPAIR checks the Retrieval Information 
Blocks (RIBS) of all directory entries that have a valid RIB 
address If a RIB address is invalid in a directory entry, 
?hen the RIB cannot be found. The RIBs are checked in the 
order in u.hich they are referenced in the ^'^^^^'^^-''.t 
RIB sector cannot be read, the follouiing message u<ill be 
displayed: 

**PROM I/O ERR0R-5TATUS=31 AT 30DB ON DRIVE 1-PSN 0570 

• RIB READ ERROR „„„„^ 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR? 

The operator must respond u,ith either a "Y" or an "N" to the 
last question. If a "Y" is entered, REPAIR .il attempt to 
T^auirite the RIB. If the error is cleared, REPAIR wiii 
::rti;ue. if an error occurs during the --i^j";.^ °^ *^ 
RIB, or if an "N" was entered, REPAIR cannot checK tne R.- 
any further. Thus, a message of the form 

03 00 00 BINEX .CM 014C 5200 0000 
RIB IN ERROR - DELETE FILE? 

is displayed to allou, the operator to delete the file 
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completely so 
first line shows 
file. It is 
explained in the 
deleted ( "N" res 
allocation table 
response}i then 
marked as avail 
allocation tabl 
file is usually 
the user. If th 
by responding uii 



it is not allocated 
the directory entry 

in the same format 
previous section. 

ponse)> it ujill not be 
be updated. If the 



space 
that 
as the 

If tb 
affect 
file i 
whatever space was allocat 
able for allocation in th 
6. If a RIB is in errors th 
unaccessible unless the error 
is cannot be done, the file s 
th a "Y" to the above prompt. 



in Phase 4. The 
belongs to the 

directory entry 
e file is not 
ed< nor will the 
s deleted ("Y" 
ed to it will be 
e reconstructed 
e content of the 

is corrected by 
hould be deleted 



If the RIB can be properly read, or if the RIB was 
properly rewritten. then REPAIR will continue to check the 
RIB for the following criteria. If the RIB fails to satisfy 

t.1.^ ...^4.B«i3 3n aT^y^nf maes^na liii 1 1 h» ^houinj folloWed bu the 

directory entry and a prompt that allows the file to be 
deleted: 



<cause of error> 

03 00 00 BINEX .CM 014C 

RIB IN ERROR - DELETE FILE? 



5200 0000 



The actual content of the directory entry, however, will 
vary. The following messages can appear in place of the 
<cause of error> field. 



FIRST SDW IN ERROR 



This error message will be displayed 
Segment Descriptor Word (SDW) does 
the cluster number of the RIB as 



cluster number, 
physical sector 
the file 's first 
be displayed if 
bit set to one. 



if the first 
not contain 
its starting 
the first 
always be in 



Since a RIB is 

of a file/ it will 

cluster. This message will also 

the first SDW has the terminator 



SDW BOUNDS ERROR 



This error message will be displayed if an SDW 
has an invalid starting cluster number. Invalid 
cluster numbers are those that include the system 
table area of the diskette as well as areas 
beyond the maximum physical sector number. 

If an SDW describes a segment which doesn't lie 
entirely within the boundaries of the diskette, 
this message will also be shown. That is, the 
contiguous clusters adjacent to the starting 
cluster of an SDW must also have valid cluster 
numbers. 



^ 
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RIB CLUSTER ALLOCATION DUPLICATION 



This error message will be displayed 
describe the same physical clusster. 
must span unique segments of the diskette. 



if two SDWs 
All eOMs 



ILLEGAL SDW TERMINATOR 



This error message will be displayed if the SDW 
that acts as the terminator for the other segment 
descriptors does not exist or if it contains a 
logical sector number (used for monitoring the 
logical end-of-file) that is not a part of the 
allocated file. 



NON-CONTIGUOUS SDW ERROR 



This error 
with the 
SDWs that 
diskette. 



message will be displayed if files 

contiguous allocation attribute have 

describe a segmented area of the 



NON-0 BYTES AFTER SDW TERMINATOR 



This error message will be displayed if bytes 
following the terminating SDW are not zero. Only 
files in the memory-image format can have 
non-zero bytes in the RIB following the 
terminator, and then only beginning with the 
117th (decimal) byte of the sector (117 is 
relative to zero; zero being the first byte in 
the RIB). 



BINARY LOAD FILE RIB ERROR 



This error message can be displayed for a variety 
of reasons. The RIB of memory-image files 
contains special load information in the last 
eleven bytes of the sector. If those bytes do 
not meet the following specifications, this error 
message will be displayed. The offsets used to 
refer to the various bytes are relative to zero 
(zero being the first byte of the RIB sector). 
All offsets are given in decimal. 

1. Byte 117, the number of bytes to load from 
the last sector, must be non-zero, a multiple 
of 8, and less than or equal to 128 ($80). 

2. Bytes llS-119, the number of sectors to load, 
must contain a number that is non— zero, less 
than the total number of sectors allocated to 
the file, and less than or equal to 512 
(«200). 
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3. Bytes 120-121^ the starting load address, are 
not checked. For programs loading in an 
EXORciser I system, in the User Hemory Map of 
an EXORciser II system with the single memory 
map configured, or in the Executive Memory 
Map of an EXORciser II system with the dual 
memory map configured, this value must be 
greater than hsssdscimal location tiF if the 
program is to be loaded via the MDOS loader. 
EXORciser II systems luith the dual memory map 
configured can have programs loaded into the 
User Memory Map starting at location zero. 

4. The ending load address is calculated from 
bytes 117-121 in the folloujing manner; 

EL = (NSL - 1) * 12B + NBLS + SL - 1 

where EL is the ending load address. NSL is 
the number of sectors to load (bytes 
118-119), NBLS is the number of bytes in the 
last sector (byte 117), and SL is the 
starting load address (bytes 120-121). The 
ending load address must be less than 65536. 

5. Sytes 122-123. the starting execution 
address, must lie uiithin the range of 
addresses spanned by the program (greater 
than or equal to the starting load address, 
and less than or equal to the ending load 
address ) . 

6. Bytes 124-127 ars not used and must be zero. 

Because of the complexity of the errors that can occur 
in a RIB, the REPAIR command uill make no attempt to "fix" a 
RIB. If a RIB error is detected, REPAIR will give the 
operator a choice of deleting the file (thereby removing the 
RIB and fixing the problem) or leaving the RIB alone. 

No space can be allocated to files uiith directory 
entries that have invalid RIB addresses or to files that have 
RIBs with detectable errors (since the allocation information 
is contained in the RIB). Thus, when REPAIR goes through the 
Phase 4, it will exclude all files with bad RIBsi however, 
the REPAIR command will not update the allocation table on 
diskette if files with bad RIBs avs left undeleted. Thus, 
the files with bad RIBs should be deleted when REPAIR gives 
the operator the option to do so (the DEL command must not be 
usedl), or they should be manually repaired via the DUMP 
command (Chapter 11) before the diskette is used. The DUMP 
command can be used to examine the damaged RIB and, if 
necessary, to examine where a file's sectors actually are on 
the diskette. DUMP'S sector read, sector change, and sector 
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write commands car. be used to reconstruct a valid RIB. 
Sometimes. it will reciuire less effort to recreate a file's 
RIB (if the allocation map has been recently printed via the 
DIR command) than to recreate the file itself. 

After a RIB has been reconstructed. REPAIR should be run 
again to ensure that there is no dual allocation with another 
file. 

After ail of the RIBs have been checked^ a summary is 
displayed to monitor REPAIR'S progress. The summary 
information takes on the foliouing format: 

XX GOOD FILES yy FILES WITH BAD RIBS 

where "xx" and "yy" ars both hexadecimal numbers. The 
display of this message indicates the end of Phase 3. 

22. 5 CAT Regeneration Phase 

Phase 4 of the REPAIR command reconstructs a cluster 
allocation table in memory from the RIBs of those files that 
have no errors ("xx" in the Phase a summary message). Phase 
4 consists of three passes. 

Pass 1 o-l' Phase 4 reads all valid RIBs. All clusters 
that ars allocated are retained in memory in a table called 
Table 1. A second table> Table 2. also in memory, will 
contain all clusters which have been allocated to more than 
one file. If no dual allocation has occurred, Table 2 should 
be empty at the end of Pass 1. If it is. the rest of Phase 4 
is skipped. 

If Pass 1 has determined that dual allocation occurred, 
then Pass 2 of Phase 4 will read all RIBs a second time. 
This time, the files which have clusters allocated in Table 2 
are flagged so the file's names and conflicts can be shown in 
Pass 3. 

A summary message is displayed at the end of Pass 2 that 
gives totals of the number of files with and without dual 
allocation. The format of the summary message is 

XX GOOD FILES yy FILES WITH DUPLICATIONS 
ZZZ2 ALLOCATION DUPLICATIONS 

where "xx". "yy".- and "zzzi" ars all hexadecimal numbers. 
The totals "xx" and "yy" refer to numbers of files. The 
number "zzzz", however, refers to the number of clusters that 
are common to the "yy" files. The actual message is 
displayed on a single line. 

Pass 3 of Phase 4 will perform an analysis of all files 
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that have allocation conflicts with each other. The files \ 
are analyzed two at a time. The result of the analysis will 
bs displayed in the following format: 

09 06 00 RASM .CM 03 IC 7200 0000 

SIZE: OOIF CONFLICTS: OOIF CLUSTERS 
10 OD 01 FORLB . RO 05D0 6300 0000 

SIZE: 0041 CONFLICTS: OOIF CLUSTERS 
03 IC 0320 0324 0328 032C 0330 0334 0338 033C 0340 0344 034S 
034C 0350 0354 0358 035C 0360 0364 0368 036C 0370 0374 0378 
037C 0380 0384 0388 038C 0390 0394 

The names of the files and the numeric data displayed differ* 
of course* depending on the exact files involved. 

The first line of the display contains the directory 
entry of a file with which other files have duplicate 
allocation. The format of the directory entry is the same as 
during Phase 2 (section 22.3). Since this line is extended 
to the left further than the other lines* this file is 
referred to in the following description as the "Outer file". 
The second line of the display contains the total size of the 
Outer file in clusters (SIZE) and the total number of 
clusters that cause allocation conflicts (CONFLICTS). When 
the .total size is compared to the part of the file that is in 
conflicti a relative indication can be obtained of the 
fraction .of the file that may be in error. The CONFLICTS 
total for the Outer file includes the allocation conflicts 
with all "Inner files" (described below). 

The third and fourth lines of the display are of the 
same format as the first two lines; however* these lines 
describe an "Inner file" that has allocation conflicts with 
the Outer file. Since more than one Inner file can be shown* 
the CONFLICTS total for each Inner file contains only the 
number of clusters in that file that cause allocation 
conflicts with the Outer file. 

Following the two-line description of the Inner file 

will be a list of. clusters (belonging to the Inner file) that 

conflict with the Outer file. The starting physical sector 
number is given for each cluster. 

After the Outer file and one Inner file have been 
displayed in this format, REPAIR will issue the following 
prompt (data supplied to go along with the above example): 

DELETE: NEITHER(l)* B0TH(2), FORLB .R0(3)> RASM .CM<4): 

The above prompt allows the user to select the action that 
REPAIR is to take by entering a number from 1 to 4. Number 1 
will cause neither the Inner nor the Outer file to be 
deleted. Number 2 will cause both files to be deleted. 
Number 3 will cause the Inner file to be deleted. Number 4 
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will cause the Outer file to be deleted. 

As long as the Outer file is not deleted/ all of the 
files that have conflicts with it will be displayed as Inner 
files. When all Inner files conflicting with the Outer file 
have been displayed in this fashion* REPAIR mill take the 
next file in its list of files with allocation conflicts and 
use it as an Outer file. This process continues until all 
files uiith allocation conflicts have been dealt with. 

Conflicting pairs of files will be printed only once. 
An Inner file may subsequently be displayed as an Outer file 
if it has additional conflicts with other files. As files 
are deleted/ other files that were originally in conflict 
with it may no longer have allocation conflicts. 

Usual ly< the REPAIR command will be used tTtore than once 
if files happen to have allocation conflicts. The first 
time, the operator will pick the "NEITHER" selection from the 
above prompt. In this way. he can accumulate the information 
required to decide which files should be deleted and which 
should be retained. The DUMP command may be used to examine 
the conflicting clusters to see which file they actually 
belong to. Then. REPAIR is run a second time to actually 
delete the files in error. The files must not be deleted 
with the DEL command since it deallocates the files' space in 
addition to deleting the directory entries.' 

For files with allocation conflicts. one of the 
following statements may be true: 

1. The Outer file may have a correct RIB and contain 
all valid data. Thus, the error is caused by the 
Inner files that have allocation conflicts with 
the Outer file. 

2. The Outer file may have an incorrect or 
overwritten RIB. In this case, the Inner files 
having allocation conflicts with the Outer file 
are al 1 correct. 

3. Some of the Outer file's existing space may have 
been erroneously allocated to. and possibly 
overwritten by. an Inner file. In that case, 
since the Inner file was written to last. the 
Inner file contains valid data and has a valid 
RIB even though its space was allocated by error. 

4. Some of the Inner file's existing space may have 
been erroneously allocated to. and possibly 
overwritten by. an Outer file. In that case, 
since the Outer file was written to last, the 
Outer file contains valid data and has a valid 
RID even though its space was allocated by error. 
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5. A combination of 2., 3> and 4 may have occurred. 

It is necessary to be knowledgeable of the MDOS file 
structure before allocation conflicts can be wisely resolved. 
It should be noted that although space is allocated to a 
file, the space may not necessarily have been written into. 

If only an Outer file is displayed ujith no Inner fii#s 
at the beginning of Phase 4, then the user has locked out 
sectors which conflict with files that already have allocated 
space. REPAIR assumed that the correct sectors were 
specified by the user during the Phase li however, if that is 
not true, then this kind of a allocation conflict will be 
seen. 






Phase 5 of the REPAIR command compares the reconstructed 
allocation table in memory with the actual allocation table 
on the diskette. If the two tables are identical (normal 
case), REPAIR will display the message 

RECONSTRUCTED C. A. T. MATCHES DISK 

before terminating and returning control to MDOS. 

If the reconstructed table does not match the one on 
diskette, and if no RIB errors remain, then the message 

WRITE RECONSTRUCTED C. A. T. TO DISK? 

will be displayed. The operator must respond with either a 
"Y" or an "N". The "Y" response will cause the new 
allocation table (the correct one) to be written to the 
diskette. The "N" response will leave the erroneous system 
table intact. MDOS will be given control after either 
response. 

The allocation table that is written to the diskette is • 
a combination of Table 1 which was built during Pass 1 of 
Phase 4, and the LCAT. If files with invalid RIBs were 
encountered during the REPAIR process which were not deleted, 
in all probability the allocation tables will differ. REPAIR 
will not update the diskette table until the files with 
invalid RIBs are fixed or deleted (but they must not be 
deleted with the DEL command — only by the REPAIR command). 
In such cases, REPAIR will display the message 

INVALID RIBS RESULTED IN RECONSTRUCTED C. A. T. NOT MATCHING 

DISK 

as a reminder that the allocation table and some RIBs contain 
errors. MDOS is given control after the message is 
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disp layed. 
22. 7 Messages 



The following messages 
coflimand. Only those messages 
preceding sections are listed. 

YCYES) OR N<NO): 



can be displayed by the REPAIR 
not already covered in the 



The REPAIR command's prompts usually accept only 
a "Y" or "N" response from the operator. If any 
other response is given* this message uill be 
displayed^ forcing a new response to be entered. 



22. 8 Examples 



The following example illustrates how REPAIR is used on 
a working diskette in drive zero to verify that the system 
tables avs correct: 



=REPAIR 

DISK ID: 

VERSION: 

REVISION: 

DATE: 

USER: 



MD0S0300 

03 

00 

072578 

SYS DEVELOPMENT DISK 



31 SOOD FILES 00 FILES WITH BAD RIBS 
RECONSTRUCTED C. A. T. MATCHES DISK 



The next example illustrates how REPAIR is used once 
just to gather information about what is wrong with the 
diskette. Then, DUMP is used to fix the directory, and 
REPAIR run a second time to verify that the error was 
corrected. The file LOS. CM is presumably a user-written 
program that functions as a command; however, the attribute 
area of the directory entry was created illegally or has been 
destroyed. 
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=REPAIR : 2 
DISK ID: M1XJS0300 
VERSION: 03 
REVISION: 00 
DATE: 07257S 
USER: SYS DEVELOPMENT DISK 
OA 07 03 LOG . CM 0570 FFFF OOQO 
ILLEGAL ATTRIBUTE OR UNUSED BYTES. DELETE? N 
NON-0 BYTES AFTER SDW TERMINATOR 
OA 07 03 LOG . CM 0570 FFFF OOOO 
RIB IN ERROR - DELETE FILE? N 
2F GOOD FILES 01 FILES WITH BAD RIBS 
INVALID RIBS RESULTED IN RECONSTRUCTED C. A. T. NOT 
MATCHING DISK 



The DUMP command (Chapter 11) can then J)e used to change 
the directory entry. Since LOG. CM is a memory-image file, 
the RIB contains load information after the terminator; 
however, the attribute part of the directory entry mas 
destroyed. Thus, REPAIR could not detect the memory-image 
format. 

From the information shown for the directory entry, it 
is .determined that the directory entry for the file LOG. CM is 
in'physical sector $0A or directory logical sector 7. The 
folloujing sequence is used to "repair" the attribute field: 
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=DUMP :2 
PHYSICAL MODE 
:RD 7 
:S 

CHANGE BUFFER 

PSN=OOOA 
00 42 41 53 49 43 20 20 20 43 4D Oi 00 7S 00 00 00 BASIC CM. . r. 
10 46 52 45 45 20 20 20 20 43 4D 02 B4 72 00 00 00 FREE CM. . v. 
20 45 51 55 20 20 20 20 20 53 41 04 BO 65 00 00 00 EQU SA. . e. 
30 4C 4F 47 20 20 20 20 20 43 4D 05 70 FF FF 00 00 LOO CM. p. . 

40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

50 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

60 00 00 OO OO 00 00 00 00 00 00 00 00 00 00 00 00 

70 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

: 3C./ 

3C FF 52/00/ 

: W 

:Q 

=REPAIR : 2 

DISK. ID: MDQS0300 

VERSION: 03 

REVISION: 00 

DATE: 072578 

USER: SYS DEVELOPMENT DISK 

30 GOOD FILES 00 FILES WITH BAD RIBS 

RECONSTRUCTED C. A. T. MATCHES DISK 

The REPAIR command mas then invoked a second time to 
ensure that the "fix" was correctly applied. Since REPAIR 
then recognized the file LOG. CM as a memory-image file* the 
RIB error disappeared automatically. 

The same error could have been corrected uiithout having 
the detailed systems knowledge that tuas used in the above 
example. If" the file were deleted/ the error tuould be fixed 
and the diskette would be a valid MDOS diskette. The 
following example shows the minimal— knowledge approach to 
fixing the diskette: 

=REPAIR :2 

DISK ID: MDOS0300 

VERSION: 03 

REVISION: 00 

DATE: 072578 

USER: SYS DEVELOPMENT DISK 

OA 07 03 LOG . CM 0570 FFFF 0000 

ILLEGAL ATTRIBUTE OR UNUSED BYTES. DELETE? Y 

2F GOOD FILES 00 FILES WITH BAD RIBS 

WRITE RECONSTRUCTED C. A. T. TO DISK? Y 
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Since the file was deleted* the reconstructed allocation 
table did not match the one on the diskette. Thus* a new one 
(uas ujritten to make the allocation table correct. 



The last example illustrates how a file just hav 
deleted by accident can be recreated if no other pro 
invoked that causes a directory entry to be created 
to be allocated or dsallccated. Since the deleti 
removes the name from the directory and frees the a 
space, all that needs to be done is to rebuild the d 
entry using DUMP» and to recreate the allocation tab 
REPAIR. The following example shows the sequence of 
from the file's deletion through its director 
reconstruction. This example assuaies that the operat 
the file's position in the directory (from DEN of a d 
listin".i. Qtherwise? the DUMP command "3D" would hav 
used to display the entire directory, allowing the 
to search for the deleted entry visually. 



ing been 
cess is 
or space 
on only 
llocated 
irectory 
le using 
events 
y entry 
or knows 
irectory 
6 to be 
operator 



=DEL TESTPROG. SA 

TESTPROG. SA: DELETED 

=DUMP 

PHYSICAL MODE 

: RD 3 

:S 

CHANGE BUFFER 

PSN=0006 
00 4D 44 4F 53 4F 56 34 20 53 59 00 08 72 



00 00 00 MD0S0V4 SY. . r. 

00 00 . . STPROGSA. . . . 

00 00 

00 00 

00 00 

00 00 

00 00 

00 00 



10 FF FF, 53 54 50 52 4F 47 53 41 05 FC 05 00 

20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

30 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

50 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

70 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

;S 

CHANGE BUFFER 

PSN=0006 

00 4D 44 4F 53 4F 56 34 20 53 59 00 38 72 00 00 00 MD0SaV4 SY. . r. 

10 54 45 53 54 50 52 4F 47 53 41 05 FC 05 00 00 00 TESTPROGSA. . . . 

20 00 00 OO 00 00 00 00 00 00 00 00 00 00 00 00 00 

30 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

40 00 00 OO 00 00 00 00 00 00 00 00 00 00 00 00 00 

50 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

70 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

: W 

:Q 

=REPAIR 

DISK ID: MDOS0300 

VERSION: 03 
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REVISION: 00 

DATE: 072 57B 

USER: SYS DEVELOPMENT DISK 

33 GOOD fILES 00 FILES WITH BAD RIBS 

WRITE RECONSTRUCTED C. A. T. TO DISK? Y 

=DIR TESTPROG. SA; A 

DRIVE : DISK I. D. : MD0S0300 

TESTPROG. SA 5 05FC 0004 31 00 05FC 004 

TOTAL NUMBER OF SECTORS : 0004 /«004 
TOTAL DIRECTORY ENTRIES SHOWN : 001/*01 

The above procedure should only be used as a last resort. It 
can be avoided completely if an adequate backup copy is kept 
of all files and if the protection attributes are set for 
those files sahich are not to be deleted. 
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23. ROLLOUT COMMAND 

The ROLLOUT command is used for writing the contents of 
memory to diskette. The ROLLOUT commanci supports the single 
and dual memory maps of EXORciser II as well as the single 
memory map of EXORciser I. Options exist for writing memory 
directly into a diskette file or for writing to a scratch 
diskette. 

23. 1 Use 

The ROLLOUT command is invoked with the following 
command line: 

ROLLOUT i<name>j L;<options>j 

where <name> is the name of a diskette file and <option5> is 
one of the options described below. The file name^ if used* 
is jiven the default suffix "LO" and the default logical unit 
number zero. In some cases, it is invalid to have the file 
name specified with logical unit number one (see section 
23.1.4). If a file name is specified on the command line/ it 
must be the name of a file which does not already exist in 
the directory. Whenever the file is created* it will be in 
the memory-image format and allocated contiguously on the 
diskette. 

There aTS four different ways in which the ROLLOUT 
command can be used. Each of the four uses of ROLLOUT is 
specified via the <options> field. 

Option Function 



U Write memory into a file from the User 
Memory Map of an EXORciser II system that 
has the dual memory map configured. 

none Write memory into a file. Only memory 
not over lay ed by MDOS or ROLLOUT command 
can be accessed. 

V Write memory to scratch diskette (not to 
a file). Any memory block can be written 
out. 

D Copy the scratch diskette's data ( "V" 
option) into a diskette file. 
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The ROLLOUT command cannot be invoked from within a 
CHAIN file (Chapter 6). Since most of the processing is done 
by a position-independent routine that must work tuithout MDOS 
being resident, the resident MDOS I/O functions cannot be 
used. Therefore,- the special keyboard keys CTL-X, CTL-D, 
CTL-W, BREAK, and RUBOUT are non-functional during the 
ROLLOUT command; however, each operator response must still 
be terminated with a carriage return. 

Caution must be used when writing out blocks of memory 
that include the highest addressed memory location *FFFF. 
Since MDOS can only load programs in a multiple of eight 
bytes. the starting load address of such programs must be an 
address that is a multiple of eight. Otherwise, the ending 
load address will be greater than 3FFFF. 

23. 1. 1 User Memory Map 

When the ROLLOUT command is invoked with the command 



line 



ROLLOUT <name>; U 



the memory from the User Memory Map of an EXORciser II system 
with the dual memory' map configured will be written into the 
diskette file <name> on the specified logical unit. If the 
dual memory map is not configured, ROLLOUT will terminate 
after displaying the following message: 

USER MEMORY MAP NOT CONFIGURED 

If the dual memory map is configured, then ROLLOUT will 
continue and display the messages 

START ADDRESS: 
END ADDRESS: 

The user responds by entering the starting and ending memory 
addresses in the User Memory Map which av.e to be written into 
the diskette file. The addresses must be input in 
hexadecimal ( *OO0O-FFFF ) , and the starting address must be 
less than or equal to the ending address. If these two 
conditions are not met, the message 

INVALID ADDRESS RANGE 

will be displayed and the operator will be given another 
chance to enter the addresses. After having supplied the 
memory range to be written to diskette, the message 

ARE YOU SURE (Y, N, Q)? 

will be displayed. The operator must respond with a "Y" to 
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have the memory iuritten into the diskette file. The mesnoTy 
block is only written into the file if sufficient contiguous 
space can be allocated. ROLLOUT will then terminate and 
return control to MDOS. 

The "N" response will cause the memory start and end 
address messages to be redisplayed in order to allow another 
set of addresses to be entered. The "Q" response will 
terminate the ROLLOUT command and return control to MDOS. 

23. 1. 2 Non-over lay ed memory 



If the ROLLOUT command is invoked with the command line 

ROLLOUT <name> 

then any block of memory not overlayed by MDOS or the ROLLOUT 
command in either EXORciser I or II (single or Executive 
memory map) can be written to the diskette file specified by 
<name>. The file can be specified to reside on any logical 
unit number. 

As described in section 23. 1. 1. the start/end address 
message prompts will be displayed; however, in addition to 
the criteria set forth in that section for valid addresseSi 
the address range must not have been overlayed by MDOS or the 
ROLLOUT command. If an address range is specified that falls 
into the overlayed memory, the message 

START ADDRESS MUST BE GREATER THAN «nnnn 

will be displayed. The "nnnn" is the last address that has 
been used by MDOS or the ROLLOUT command. The operator is 
then given a chance to re-enter the addresses. Otherwise, 
the function of the ROLLOUT command is similar to the 
function described in the previous section. 

23.1.3 Overlayed memory 

If the ROLLOUT command has been invoked with the command 



1 ine 



ROLLOUT iV 



then any block of memory can be subsquently written to a 
scratch diskette. A position-independent routine will be 
moved into memory. This routine can subsequently be 
activated by the user from the debug monitor after loading 
his test program into memory. The routine will be used to 
write memory to a scratch diskette that has been placed into 
drive one. 
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No file name specification can be entered u/ith the "V" 
option The diskette that will be written to in drive one 
must not contain an MDOS system that is to be used again. 
The system tables on that diskette will be overwritten. The 
diskette will have to be regenerated in order to be used as 
an MDOS system diskette. 

ROLLOUT uiill display the following message once it has 
been invoked with the "V" option: 

LOAD ADDRESS: 

to which the operator must respond with the starting 
hexadecimal address of a memory block into which the ROLLOUT 
command will attempt to move the position-independent 
routine. The address must be for memory above that required 
by MDOS and the ROLLOUT command. If the address gi.ts. ed is 
too low, ROLLOUT will display the message 

LOAD ADDRESS MUST BE GREATER THAN *nnnn 

•and return control to MDOS. "nnnn" is the hexadecimal 
address of the last location in memory occupied by MDOS or 
the ROLLOUT command. If the entered address specified spans 
non-existent memory, ROLLOUT ujili display the standard error 



message 



»* 53 INSUFFICIENT MEMORY 



and return to MDOS. 



Caution must be used in locating the 
position-independent routine in memory. Since MDOS uses the 
upper end of memory when the command interpreter is running, 
the routine should not be loaded within 100 (decimal) bytes 
of the end of contiguous memory. Care must also be taken to 



ensure that the program being tested does not destroy 



the 



ensure Tnai; T;ne p7-oyioi»» ucii.y «.= = »■..- ---- 

«200 locations occupied by the position-independent routine. 

If the position-independent routine was successfully 
transferred, ROLLOUT will terminate and return control to 
MDOS The user can then invoke the LOAD command to bring his 
test program into memory. Then, whenever the time is reached 
that memory is to be written to diskette, the user need only 
nive control to the still resident position-independent 
routine at the address that was entered in response to the 
"LOAD ADDRESS" prompt discussed above. This is done via -he 
EXbug command 

nnnn; <3 

When the position-independent routine receives control in 
this manner, it will prompt the operator for the starting and 
ending addresses as described in section 23. 1. 1. After the 



_y 
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address range has been entered and the "Y" response given to 
the "ARE YOU SURE?" question, the message 

DRIVE 1 SCRATCH? 

will be displayed. At this point/ a scratch diskette must be 
placed into drive one. A "Y" response tuill then cause the 
block of memory to be written to the scratch diskette. Any 
other response uiill give control to the debug monitor. 

The "N" response to the "ARE YOU SURE?" prompt will 
allou) the address range to be reentered. The "Q" responsej 
howeveri u/ill return control to the debug monitor* rather 
than to MDOS. After the block of memory has been rolled out, 

the debug monitor will receive control again. 

The ROLLOUT command can be subsequentiy used (see 
section 23. 1. 4) to copy the Ta\D data from the scratch 
diskette into a file on drive zero. 

23.1.4 Scratch diskette conversion 



If the ROLLOUT command is invoked with the command line 

ROLLOUT <name>j D 

then the memory written to the scratch diskette u/ith the "V" 

option will be copied into the file <name>. ROLLOUT mill 

assume that a scratch diskette is in drive one that has been 

created via the ROLLOUT command with the "V" option. The 

<name> specified must be for logical unit zero. Since the 
diskette in drive one is scratch. no file can be created 
there. 

The ROLLOUT command will display the following message 
once it has been invoked with the "D" option: 

DOES DRIVE 1 CONTAIN A MEMORY ROLLOUT? 

to- which the operator must respond with a "Y" if the ROLLOUT 
command is to continue. Any other response will terminate 
the ROLLOUT command and return control to MDOS. 

If the "Y" response is given to the above message. 
ROLLOUT will check that the diskette in drive one was 
generated with the "V" option. If an invalid diskette has 
been placed into drive one. the message 

INVALID DISKETTE IN DRIVE 1 

will be displayed and ROLLOUT will be terminated. If a valid 
diskette is found, then ROLLOUT will proceed to build a file 
on drive zero that contains the memory information from the 
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scratch diskette. 
23. 2 Messages 



The following messages can be displayed by the ROLLOUT 

command. Not all messages are error messages> although error 

messages aT@ included in this list. The standard error 

messages that can be displayed by all commands are not listed 
here. 



START ADDRESS: 



END ADDRESS: 



The starting address of the block of (n«fflory to be 
written out must be entered. 



The ending address of the block of memory to be 
written out must be entered. 



INVALID ADDRESS RANGE 



The starting address was greater than the ending 
address, or one of the two addresses contained an 
invalid hexadecimal number. 



ARE YOU SURE (Y, N, Q)? 



This message allows the operator to verify that 
the starting/ending addresses entered are what he 
wants. The "Y" response will cause ROLLOUT to 
continue. The "N" response will allow a new 
address range to be entered. The "Q" response 
will terminate the ROLLOUT command. 

DRIVE 1 SCRATCH? 

This message is displayed by the 
position-independent routine to allow the 
operator a chance to insert a scratch diskette 
into drive one. A "Y" response will cause the 
memory to be written to the diskette. Any other 
response will return control to the debug 
monitor. 

START ADDRESS MUST BE GREATER THAN «nnnn 

The start/end addresses include memory occupied 
by MDOS and/or the ROLLOUT command. If this 
memory is to be written out. ■ the ROLLOUT command 
should be invoked with the "V" option. 
Otherwise. the start/end addresses must be 
greater that "nnnn". 
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LOAD ADDRESS MUST BE GREATER THAN *nrmn 



The address specified for locating the 
position— independent routine in memory includes 
memory occupied by MDOS and/or the ROLLOUT 
command. The address must be greater than *nnnn 
shoun in the message. 



USER MEMORY MAP NOT CONFISURED 



The "U" option has been specified on an EXORciser 
I system or on an EXORciser II system that has no 
dual memory map configured. 

LOAD ADDRESS: 

The operator must specify an address at which the 
position— independent routine will be located for 
subsequent access via the debug monitor. The 
load address entered will be the starting 
execution address that is used to activate the 
ROLLOUT routine from the debug monitor. 

DOES DRIVE 1 CONTAIN A MEMORY ROLLOUT? 

This message allows the operator time to_ insert 
the scratch diskette created via a previous 
ROLLOUT process tuith the "V" option into drive 
one before ROLLOUT will convert the data into a 
diskette file on drive zero. A "Y" response will 
cause ROLLOUT to continue. Any other response 
will cause control to be returned to MDOS. 

INVALID DISKETTE IN DRIVE 1 

This message indicates that the diskette in drive 
one was not created by the ROLLOUT command with 
the "V" option. 

»« 53 INSUFFICIENT MEMORY 

The operator specified an address which started a 
block of memory that does not exist or that 
contains bad memory. This block is used to 
receive a copy of the position— independent 
routine that is given control from the debug 
monitor. $200 bytes of memory must be available 
starting at the address entered by the operator. 
The cautions listed in section 23.1.3 should also 
be reviewed. 
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23.3 Examples "^ 

The following example shows the operator-system dialogue 
for writing a block of memory to a file from the User Memory 
Map of an EXORciser II system with the dual memory map 



configured: 



=ROLLOUT UMBLDCK; U 

START ADDRESS: 100 

END ADDRESS: 7FF 

ARE YOU SURE <Y, N, Q)? Y 



The file named UMBLDCK. LO will be created on drive zero. It 
uiill contain the block of memory from $100 to «7FF. 
inclusive^ from the User Memory Map. 

The folloujing example illustrates how a copy of the 
diskette controller ROM can be written into a diskette file: 

^ROLLOUT DISKROM: 2 

START ADDRESS: ESOO 

END ADDRESS: EBFF 

ARE YOU SURE <Y, N. Q)? Y , 

The file named DISKROM. LO will be created on drive two. This 
example is valid for either type of EXORciser system. 

The following example shows how the ROLLOUT command is 
used to write memory to disk during a test session of a user 
program that overlays MDOS. A maximum contiguous memory 
range of 32K is assumed. 

=ROLLOUT 5 V 

LOAD ADDRESS: 7F80 

** 53 INSUFFICIENT MEMORY 

^ROLLOUT ; V 

LOAD ADDRESS: 7D00 

=LOAD TESTPROG; V 

» <User does testing here via EXbug) 

«7D00i G 

START ADDRESS: 100 

END ADDRESS: 5FFF 

ARE YOU SURE (Y, N, Q)? N 

START ADDRESS: 100 

END ADDRESS: 2FFF 

ARE YOU SURE (Y, N, Q)? Y 

DRIVE 1 SCRATCH? Y 

» 

In the above example, the operator initially specified a 
block of memory which was too small to receive the 
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position-independent routine. $200 bytes ars required to 
contain the routine; howeveri since the end of memory is used 
by the MDOS command interpreter/ an additional block of 
memory is allowed for the MDOS stack. Thus. the ROLLOUT 
command had to be invoked again. Then, after loading and 
testing his program, the operator invoked the routine via the 
"7D00i G" EXbug command. After entering the end address, the 
user realized an error, and responded "N" to the "ARE YOU 
SURE?" q.uestion. Testing can be continued after the block of 
memory has been written to the diskette. 

The last example illustrates how the scratch diskette 
generated above is converted into a file: 

=ROLLOUT TESTROLL; D 

DOES DRIVE 1 CONTAIN A MEMORY ROLLOUT? Y 

The file named TESTROLL. LD mill be created on drive zero. 
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24. SYSTEM DESCRIPTION 



This chapter contains the detailed descriptions of the 
-i.-.y,4.jj-g 2f 3J, MDOS diskette^ the structure of MDOS files 
and their formats, the system overlays, the memory map. the 
command interpreter, interrupt handlers, the system function 
handler. and the MDOS eq,uate file. The subsequent three 
chapters contain the detailed descriptions of the individual 
system functions and hou) they are parameterized. 

24. 1 Diskette Structure 



MDOS is based on a single- or double-sided, 
single-density flexible disk, or diskette. The diskette is 
compact in size. portable.- fairly durable. and easily 
inserted into and removed from the diskette drives. Due to 
the diskette's portability and interchangeab ility. each 
diskette is treateid by MDOS as a complete. self-contained 
entity. Each diskette has its outn system tables, operating 
system, and files. 

Information on an MDOS diskette is stored in sectors 12S 
(decimal) bytes in size. As the diskette turns. the 
read/write head in a stationary position will pass over 26 
(decimal) sectors each revolution. The area accessible to 
the stationary head on one side of the diskette is called a 
track. The area accessible to the stationary head on both 
sides of the diskette is called a cylinder. The head can be 
positioned over 77 (decimal) discrete cylinders. Thus, there 
are a total of 2002 (decimal) sectors on each surface cf a 
diskette. A single-sided diskette only has one surface that 
can be read from and written to. A double-sided diskette has 
two surfaces. 

In order to minimize access time and yet provide for a 
dynamic allocation scheme, all diskette space allocation is 
done in terms of clusters. rather than sectors. MDOS 
clusters consist of four, physically sequential sectors. A 
cluster is the smallest structural unit of information on the 
diskette. Thus, the smallest possible size that a file can 
have is one cluster. 

The following table summarizes these diskette 
statistics. 
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Quantity 



Surfaces/diskette 

Bytes/sector 

Sectors/track 

Tracks/cylinder 

See tors /cylinder 

Cylinders/diskette 

Sector-s/ surface 

Sectors/diskette 

Sectors/cluster 

Clusters/diskette 



Single-sided Double-sided 
Decimal Hex Decimal Hex 





■' ■ 


^ ^ ~" ™" *■" ^"~* 




1 


1 


2 


2 


128 


30 


12a 


SO 


26 


lA 


26 


lA 


1 


1 


2 


2 


2h 


lA 


52 


34 


77 


4D 


// 


4D 


2002 


7D2 


2002 


7D2 


2002 


7D2 


4004 


FA4 


4 


4 


4 


4 



500 



1F4 



1001 



3E9 



MDOS accesses sectors on the diskette via a physical 
sector number <PSN). The diskette controller decodes the PSN 
into the appropriate cylinder/sector position. To avoid 

sector numbers given in this section will 

If a need should arise to 



confusion* all 

refer to physical sector numbers. .. _ 

convert between cylinder/sector and physical sector numbers. 
Appendix A has been provided. It contains the physical 
sector numbers of the first sector of each cylinder on each 
surface. 



A portion of each diskette is reserved for some special 
system tables. These tables reside in the outermost cylinder 
of the diskette. cylinder zero. Each table. with the 
exception of the directory, occupies a single sector. The 
following table summarizes the location of the system tables: 



System table 



PSN 



Diskette Identification Block 
Cluster Allocation Table 
Lockout Cluster Allocation Table 
Directory 
Bootblock. MDOS RIB 



*oo 

•$01 

«02 

«03-16 
$17. 18 



24. 1. 1 Diskette Identification Block 



The Diskette Identification Block is created during 
system generation. It contains an ID. the version and 
revision number of the resident operating system. the date 
the diskette was generated, a user name identification area, 
and a dynamic area .for the MDOS overlay RIB addresses. 
ID is displayed by the DIR, FREE, and REPAIR commands. 



The 
The 



y 
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Diskette Identification Block has the follouiing format: 
Bytes Size Contents 

0-7 8 Diskette ID 

8—9 2 Version number 

$A-B 2 Revision number 

*C-11 6 Generation date 

$12-25 $14 User name 

$26-39 $14 MDOS overlay RIB addresses 

$3A-*7F $46 Zeroes 

24. 1.2 Cluster Allocation Table 

the areas on the diskette that are available for new space 
allocation. Each bit in the CAT represents a physical 
cluster of diskette storage. The first bit of the first byte 
of the CAT (bit 7 of byte 0) represents cluster 0. The 
subsequent bits represent subsequent clusters. A bit set to 
one indicates that the cluster is allocated. If a bit is set 
to zero. it indicates that the corresponding cluster is 
available for allocation. Since not all 12S bytes of the CAT 
correspond to physical clusters, the parts of the CAT that 
represent clusters beyond the physical end of the diskette 
are marked as allocated so that they cannot be used by any 
MDOS functions. 

On single-sided diskettes- bytes 0-«3E of the CAT 
correspond to the physical locations on the diskette; 
however/ in byte $3Ej bits 0-3 are set to one since no 
physical sectors correspond to 'those cluster numbers. Bytes 
$3F-7F are set to all ones. The cluster division for 
allocation only includes 2000 (decimal) sectors. Since there 
are 2002 sectors, the last two physical sectors of a 
single-sided diskette are not available for allocation 
($7D0-7D1). 

On double-sided diskettes, bytes 0-«7D correspond to the 
physical locations on the diskette; houever* in byte *7D. 
bits 0-6 are set to one since no physical sectors correspond 
to those cluster numbers. Bytes $7E and $7F are set to all 
ones. The cluster division for allocation includes all 
physical sectors (4004i decimal). There are no unused 
sectors on a double— sided diskette. 

24.1.3 Lockout Cluster Allocation Table 



The Lockout Cluster Allocation Table, or LCAT, is 
similar to the CAT in structure; however, it is only used 
during the DOSCSEN and REPAIR processes. The LCAT provides a 
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map of which areas of the diskette have been flagged as bad 
during the DOSGEN write/read test. In additionj the LCAT is 
configured so that those sectors of the diskette occupied by 
the system tables in cylinder zero and any user locked out 
areas (see Chapter Id DOSGEN command) are flagged as 
unavailable for normal allocation. 

24. i. 4 Directory 



The directory occupies twenty sectors. Each directory 
sector contains eight entries of sixteen bytes each. Each 
entry contains a file name; a suffix? the address of the 
file's first clusteri the file's attributes; and some room 
for expansion. 

A file is one or more clusters containing related 
information. This information may be ASCII source programs* 
binary object recordsi user— generated data» etc. Each file 
must reside mholly on a single diskette. Flies ars 
identified to the system by their names. suffixes* and 
logical unit numbers. 

The name as stored in the directory consists of ten 
bytes; however the MDOS command interpreter deals with an 
eight-byte name, and a two— byte suffix. This is merely a 
convention of the command interpret-er and has no significance 
in relation to the internal format of the directory. System 
routines and functions dealing uiith file names as a parameter 
use a ten-byte block which, is always dealt with as a 
monolithic item. 

File names assigned by the user must be from one to 
eight alphanumeric characters in length. The first character 
must be alphabetic. A file's suffix is used to further 
identify the file. The suffix is primarily used to identify 
the format of the file content; however, this is purely a 
convention; the attribute field of the directory entry 
describes the file's physical format. Suffixes are 
considered as an extension of the file name. They can be one 
or ttajo alphanumeric characters in length. The first 
character of the suffix must be alphabetic. Both the file 
name and the suffix* if shorter than their maximum allowable 
lengths* ars left justified and space-filled in the directory 
entry. 

In most cases* the MDOS commands make certain default 
assumptions about a file's suffix if it is not explicitly 
specified by the operator; however* explicit suffixes can be 
used whenever the default is to be overridden. The standard 
MDOS .default suffixes ars: 



^ 



\ 
J 
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Suffix Implied meaning 

AL Assembly listing file 

CF Chain procedural file 

CM Command file file 

ED EDOS-converted file 

LO Loadable^ memory-image file 

LX EXbug-loadabls file 

RQ Relocatable object file 

SA ASCII source file 

SY Internally-used system file 

Logical unit numbers identify the drive that contains 
the file. Since each diskette carries with it its own 
directoryi different files with identical names and suffixes 
can reside on different diskettes. 

The standard format for specifying file names, suffixes 
and logical unit numbers is: 

<f ile name>. <suf f ix>: <logical unit number> 

luhere the period (. ) and colon (: ) serve to delimit the start 
of the suffix and the logical unit number fields, 
respectively. 

In addition to a name, each directory entry contains a 
set of attributes which characterize the file's content. A 
file's attributes include inherent attributes and assignable 
attributes. The inherent attributes of a file describe its 
allocation scheme (contiguous or segmented)/ the file format 
(ASCII record, binary record, memory-image, or user-defined), 
and whether space compression is used for ASCII records. The 
file formats sre described in section 24. 3. 

The assignable attributes include write protection, 
delete protection, and the system file attribute. If a file 
is write protected, it cannot be written into or deleted. If 
a file is delete protected, it cannot be deleted. If a file 
has the system attribute, it will be included in the system 
generation process (DOiSGEN) and is handled differently by the 
DEL and DIR commands. 

The. format of a directory entry is described in the 
following table: 
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Bytes 


Size 


Contents 


— — — 







«0-7 


8 


File name 


«8-9 


2 


Suffix 


«A-B 


2 


PSN of first cluster 


*C-D 


2 


Attributes 


%E.-r 


2 


Zeroes 



The attribute field 
following format: 



if a directory entry has the 



B 



B 



File format 



Not Used (=0) " 

<0=user-def inedi 
2=men»ory-imagei 
3=binary record» 
5=ASCII record. 
7=ASCII-convert8d- 
binary record ) 

Non-compressed space bit 
Contiguous allocation bit 
System file bit 
Delete protection bit 
Write protection bit 

Associated with each directory entry is an eight-bit 
number, the directory entry number <DEN). which is a function 
of the physical location of the entry within the directory. 
The DEN is not found anywhere in the directory. It is a 
calculated q.uantity and is interpreted as follows: 



Position within sector 
<0-7) 

Physical sector number 
(«3-$16) 



24. 1. 5 Bootblock 



The Bootblock is a small loader program that is brought 
into memory along with the next physical sector by the 
diskette controller during system initialization. The second 
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sector that is loaded contains information regarding the size 
of the resident operating system. From this information! the 
Boetblock program configures the diskette controller to load 
into memory the actual resident operating system. 

24.2 File Structure 

While the contents of a file can be thought of as a 
logically contiguous block of information/ the actual 
diskette area allocated to the file may or may not be 
physically contiguous. Space can be allocated to one or more 
groups of physically contiguous clusters on the diskette. 
Each contiguous group of clusters is called a segment. This 
segmentation allouis the dynamic allocation and deallocation 
of space to occur without having to move any of the 
information contained in the file or in ot.isr ,i*ts. 

Each file must, therefore) have a table that describes 
mhich segments are allocated to the file. This table is kept 
in the first physical sector of each file and is called the 
Retrieval Information Block (RIB). It is the address of the 
RIB that is contained in the directory entry of a file. 

MDQS accesses sectors within a file by logical sector 
number (LSN). Since the first physical sector of a file is 
not really a data sector^ the RIB is given an LSN of minus 
opg (^ppprp) Therefore, logical sector zero of a file (the 
first data sector) is actually the second physical sector of 
the file. Logical sector numbers for data sectors are 
numbered sequentially beginning with zero. Thus, even though 
a file may be segmented (not physically contiguous on the 
diskette), it is treated as a logically contiguous collection 
of sectors when accessed by logical sector number. The 
system I/O functions decode the LSN into the actual PSN. 

24.2.1 Retrieval Information Block 



For all files, the RIB contains a series of two-byte 
entries called segment descriptor words (SDWs). A special 
SDW is used as a terminator to indicate the end of the 
segment descriptors within the RIB. Each SDW (other than the 
terminator) contains two pieces of information: the cluster 
number of the first cluster in the segment, and the length^of 
the segment. Since each segment consists of physically 
contiguous clusters, this information is all that is needed 
to describe where a segment of the file is located on the 
diskette. A RIB can contain a maximum of 57 (decimal) SDWs 
and one terminator. 

The RIB of a memory-image file contains some additional 
information that describes where the contents of the file are 
to be loaded in memory. This information includes the 
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starting load address* the number of sectors to load* the n 
number of bytes in the last sector* and the starting 
execution address. 

The memory-image file load information is described in 
the following paragraphs. Both the content and the location 
of each field are described. The offsets used to refer to 
the various bytes mrs reiativs to istq (lero being the first 
byte of the RIB sector). All offsets ar^ given in decimal. 

1. Byte 117/ the number of bytes to load from 
the last sector* must be non-zero* a multiple 
of S* and less than or equal to 128 («80). 

2. Bytes llS-119* the number of sectors to load. 
must contain a number that is non-zero* less 
than the total number of sectors allocated to 
the file* and less than or equal to 512 
($200). 

3. Bytes 120-121* the starting load address* bts 
not checked. For programs loading in an 
EXORciser I system, in the User Memory Map of 
an EXORcier II system with the single memory 
map configured, or in the Executive Memory 
Map of an EXORciser II system with the dual 
memory map configured. this value must be 
greater than hexadecimal location «1F if the 
program is to be loaded via the MDOS loader. 
EXORciser II systems can have programs loaded 
into the User Memory Map of the dual memory 
map configuration starting at location zero. 

4. The ending load address is calculated from 
bytes 117-121 in the folloujing manner: 

EL = <NSL - 1) * 128 + NBLS + SL - 1 

where EL is the ending load address* NSL is 
the number of sectors to load (bytes 
118-119)* NBLS is the number of bytes in the 
last sector (byte 117)* and SL is the 
starting load address (bytes 120-121). The 
ending load address must be less than 65536. 

5. Bytes 122-123* the starting execution 
address. must lie within the range of 
addresses spanned by the file (greater than 
or equal to the starting load address* and 
less than or equal to the ending load 
address). 

6. Bytes 124-127 are not used and must be zero. 
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File Structure 



The following diagrams illustrate the format of 
segment descriptor word and the terminator. 

SEGMENT DESCRIPTOR WORD 

rEDCBA98765432 1 



< Starting cluster number — 

Number of contiguous clusters - 1 
Zero (Non— terminator bit) 



TERMINATOR 



8 



Logical .sector number of logical end-of-file 

One (Terminatox" bit) 






The SDW terminator is used to monitor the logical 
end-of-file. It contains the logical sector number of the 
end-of-file. The sector uihich is the end of a file may be 
partially filled with null characters. Thus, no actual 
end-of-file record will be found within a file. This feature 
allows files to be merged together without having to read 
through the entire file looking for an end-of-file record. 

The actual format of a RIB is shown in the following 
diagram. For non-memory-image files, the bytes following the 
terminator must all be zero. Only memory-image files can 
have non— zero bytes following the terminator, and then those 
bytes must meet the six criteria listed above. 
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00 



02 



04 



74 

76 

78 

7A' 

7C 

7E 



DCBA9S765432 
SDW O 



SOW 1 



■v 


Other SDWs 

1 
1 


TERMINATOR ! 




1 
I 

Zeroes ^ 

1 




I BYTES IN LAST SECTOR 1 


! NUMBER OF SECTORS TO LOAD 1 


! STARTING LOAD ADDRESS 1 


1 STARTING EXECUTION ADDRESS ! 


« 


ZERO ! 




ZERO ' 



24.2.2 File formats 



MDOS deals with four types of file formats an diskette; 
user-def inedi memorij-image> binary record, and ASCII record. 

User-defined files ars dealt ijjith by MDOS at the sector 
level. MDOS mill keep track of where the file is and will 
only alloui access to the file by logical sector number. The 
user has the responsibility of formatting the data within the 
sectors in the manner suited to his application. 



Memory 
to be loa 
MDOS loader 
space on 
where the c 
The data 
record info 
memory to 
control IsT' 
eight byte 



— i ma g e f 
ded int 
Memor 
the disk 
ontent i 
with in 
rmation. 
be loade 
MDOS pr 
5. A 



iles inc 
o memory 
y — i ma g e 
ette. T 
s to be 
the sect 

It is 
d into, 
ograms c 
further 



lude all files whose contents are 

directly from the diskette by the 

files are allocated contiguous 

he only information retained about 

loaded is kept in the file's RIB. 

ors of the file contain no load or 

merely an image of a block of 

Due to the nature of the diskette 

an only be loaded in multiples of 

restriction placed on memory-image 
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files is that their content cannot load below memory location 
$20 if they are to reside in the single memory map of an 
EXORciser I or EXORciser II system. 

Binary record files are used primarily for the 
relocatable object data produced by the Macro Assembler and 
the relocatable FORTRAN compiler; however* the user can 
create data files using this binary record format as uiell. 

ASCII record files are used to contain ail other 
MDOS-supported data. Such files can be in either 
space— compressed or non— space-comprsssed form. Normally/ 
MDOS will always create ASCII files with the 
space-comf^ression attribute to conserve diskette space. 

The non— memory-image files can be allocated in either 

such files in a segmented manner to take advantage of the 
dynamic allocation scheme. If files are segmented, they can 
expand to the full capacity of the diskette when they need to 
grow in sizei however, if files have contiguously allocated 
space, then they can only be expanded if they are allocated 
space that is contiguous to the originally allocated space. 
Normally, contiguous files are created with the maximum space 
that they will ever need. 

24. 3 Record Structure 



This section describes in detail the two record types 
supported for diskette files. In addition, a special record 
type used for copying binary files to a non-diskette device 
is also discussed. The actual use of such records is fully 
discussed in Chapter 25 which describes the supported I/O 
functions. All records supported by MDOS are terminated by a 
carriage return, line feed, and null seq.uence; however, on 
the diskette, only the carriage return character is retained 
in order to conserve diskette space. When diskette files are 
copied to a non— diskette device, the other two characters are 
automatically supplied by MDOS. 

24.3.1 Binary records 



Binary records are used primarily as output from the 
Macro Assembler and the FORTRAN compiler, and for input to 
the Linking Loader. Binary records contain a special record 
header, a byte count, and a checksum. The checksum is a 
two 's-comp lemented sum of all bytes in the record from the 
byte count through the last data byte, inclusive. A maximum 
of 254 (decimal) data bytes can be contained in each binary 
record. 

The format of a binary record can be illustrated as 
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f ollotiis: 



— / / 

D ! BC ! DATA i CK J CR I 



The symbols take on the folloujing meanings: 
Symbol Meaning 



The binary record header character 
($44). 



iiri" 



•D 



BC A one byte "byte count" that contains the 

one (for the checksum byte). 



kii-^Af? -in -ma T*af"r»ir*rt 



DATA A maximum of 254 (decimal) data bytes. 
Any eight-bit values arm valid for the 
data bytes. 

CK The two 's-complemented sum of the byte 
count and ail data bytes. CK is a one 
byte field. 

CR The' terminating carriage return. For 

non-diskette devices this luill actually 

be a carriage returni line feed* and null 
sequence. 

Since diskette files contain the logical end-of-file 
indicator in the RIB. the binary EOF record only will be seen 
on non-diskette devices. The binary EOF record has the 
following format: 



E ! BC ! CK ! CR ! 



The symbol "E" is the end-of-file record header which is the 
letter "E" <*45). The other symbols are the same as in the 
above table. The EOF record has no data bytes. Thus* the 
byte count will be equal to one. 

24. 3. 2 ASCII records 

ASCII records are used primarily for source files on the 
diskette! however. EXbug-loadab le format files are ASCII even 
though they are object files output from the assemblers or 
Linking Loader. 

ASCII records contain no record headers, byte counts, or 
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checksum fields. The first ASCII record in a file begins 
with the first data character of a file and is terminated by 
the first carriage return. All other ASCII records in the 
file begin with the first data character following a carriage 
return. When ASCII records are copied to non-diskette 
devices. the terminating carriage return is actually a 
combination of three control characters: carriage return, 
line feed. and null. ASCII records should contain only 
displayabls characters. 

When MDOS writes ASCII records to diskette. they 
normally contain space compression characters to conserve 
diskette space. A space compression character is indicated 
by a data byte having the sign bit (bit 7) set to a one. The 
remaining bits (0-6) contain a binary number representing the 
number of spaces CS20) to be inserted in place of the 
compressed character. MDOS automatically expands these 
characters into spaces when such files are read. MDOS will 
also automatically create these compressed characters when 
such files are uiritten. 

Since MDOS maintains the logical end-of-file indicator 
in a file's RIB. no ASCII EOF record will be seen in a 
diskette file; however, when ASCII record files are written 
to a non-diskette device, the following EOF recoTi will be 
supp lied: 



lA ! CR 



where the "lA" symbol represents the end-of-file indicator. 
It is the hexadecimal value «1A or SUB control character 
(CTL-Z). The CR symbol is the carriage return. _ line feed. 
and null sequence. 

If ASCII record files generated on another system are to 
be processed by MDOS. it is important that the carriage 
return, line feed, and null sequence be present at the end of 
each record. Otherwise, it is possible for each data record 
to lose one or two characters from its beginning. 

24.3.3 ASCII-converted-binary records 



A special form of the binary record exists when copying 
to a non-diskette device that can only accept seven-bit data. 
This record format is usually never kept in a diskette file. 
The format of the ASCII-converted-binary record is identical 
to the binary record; however, each byte, with the exception 
of the special header character and the terminating carriage 
return, line feed, and null sequence., is converted into two 
eight-bit bytes with bit seven set to zero. This is 
accomplished by taking each half of the original byte and 



Page 24-13 



SYSTEM DESCRIPTION 24.3 — Record Structure 

adding the bit mask 7.00110000 to the half-byte. The result 
is a displayable two-byte sequence. For example^ the 
hexadecimal data byte $85 luould be converted into the tsuo 
byte sequence $38 and $35. 

24.3.4 File descriptor records 



MDOS I/O operations uith non-diskette devices can be in 
one of tujo modes: file format or non-file format. The 
non-file format mode requires no special processing and uses 
only the ASCII record format. 

The file format mode allows MDOS to treat the data on 
certain non-diskette devices as a "file"> similar to a file 
on diskette. The File Descriptor Record <FDR) is employed to 
serve the same function as a directory entry for a diskette 
file. The FDR contains a file name* suffix* and a file 
format descriptor. Thus. MDOS can search for a named file on 
a cassette or paper tape* if it was originally created using 
the file format mode. 

All FDRs are identical in format* regardless of the 
record format of the data file. Since the FDR must be 
acceptable to any device. it is written in the 
ASCII-converted-binary form* even if the remaining data of 
the file is in binary or ASCII. The FDR format is shown in 
the following diagram: 



i H 1 BC ! NAME ! SUFX ! NU ! FDF ! NU ! CK ! CR 
The symbols take on the following meanings: 






Page 24-14 



SYSTEM DESCRIPTION 



24. 3 



Record Structure 



Symbol Meaning 



H 
BC 



The FDR header character "H" (*4S). 

A one-byte "byte count" that contains the 
number of bytes in all fields from NAME 



through CK» inclusive, 
fixed for FDR records at 
This number reflects the 
in the unconverted binary 
bytes written 



This number is 

17 (decimal). 

real data bytes 

forfflj not the 

in the 



NAME 



ASCII-converted— binary form. 
The eight— character file name. 



NU A two-byte field which is 
contains zeroes. 



not used. 



It 



FDF A two— byte field similar in format to the 
attribute field of a directory entry. 
Only bits $8-$A are used to describe the 
file format. 



CK 



CR 



The two 's— complemented sum of the byte 
count and all other data bytes. CK is a 
one byte field. 

The terminating character sequence of 
carriage return^ line feed^ and null. 



The length of all fields of the FDR (except H and CR ) is 
doubled uihen written (ASCI I-converted-b inary format). Thus> 
if the CR field is counted as three characters (carriage 
return* line feed* null)» then the physical length of an FDR 
in the ASCI I-converted-b inary format is 36 (decimal) bytes. 

24.4 System Files 



On every MDOS diskette 
comprise the operating system, 
resident operating system* a ser 
main memory requirements of the 
messages. The resident opera 
reside in a fixed place on the 
program is to work after be 
controller. The other system f 
positions after MDOS has bee 
referenced by their physical sec 



there are nine files which 
These files contain the 
ies of overlays to reduce the 
system. and standard error 
ting system file MDOS. SY must 
diskette if the Bootblock 
ing activated by the diskette 
iles must remain in fixed 
n initialized since they are 
tor numbers. 
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24. 4. 1 System overlays 

The system overlay files are loaded into memory into one 
of the four overlay regions discussed in the subsequent 
section. The overlay handler only brings an overlay into 
memaru if it is not already in memory at the time a specific 
function is required. If an overlay remains in memory, 
access to its function is faster than if it has be to loaded 
from the diskette. The functions contained in the seven 
overlay files are shown in the folloujing table: 



Overlay 



Function 



1 1 nrat i on 



and 



deallocation. 



MDOSOVl. SY 



Processing standard file names, 
allocating contiguous memory. 
reserving a device. releasing a 
device. writing standard records, 
writing FDRs. writing end-of-file 
records. console reader/punch device 
handling. 



MD0SaV2. SY 



Head ing 
FDRs. . 



standard records. 



reading 



MDOSOVS. SY Closing a file/device, 
diskette files, changing 
and attributes. 



rewinding 
file names 



MD0S0V4. SY Opening a file/device. 
MD0S0V5. SY CHAIN file execution. 
MDOSOVA. SY Command line interpretation. 



When MDOS is initialized, the directory is searched for 
the seven overlays by name. The physical diskette addresses 
are then retained so that a subsequent 



reference to an 



overlay function does not involve another directory search. 
Thus. MDOS must be reinitialized each time the diskette in 



Th 

drive 

again 



zero 



is changed so that the overlays can 



located 



and MDOSOVl use overlay region one. 
MD0SOV3 use overlay region two. 
MD0S0V5 use overlay region three, and 
Area into which the 



Overlays MDOSOVO 
Overlays MD0S0V2 and 
Overlays MD0SaV4 and 
overlay MD0S0V6 uses the User Program 
MDOS commands also are loaded. The overlay regions avs shown 
in the memory map diagram of section 24. 5. 



.J 
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24.4.2 System error message file 

In an attempt to use English language descriptions for 
the various error conditions that may arise* all standard 
error messages are kept in the system file MDOSER. SY. This 
file is accessed by the error message function . MDERR 
(section 27.4). The error messages ars placed in this file 
30 that the most frequently used messages are near the 
beginning. 

If the error message file cannot be read or accessedi 
the error message function will display a message indicating 
that an invalid error message has been requested. 

24. 5 Memory Map 



The memory mapping of MDOS within the EXORciser system 
is illustrated in the follouing diagram: 
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0000 
0020 


! DISKETTE CONTROLLER VARIABLES 1 

UNUSED DIRECT ADDRESSING 
AREA 


OOAE 


I COflHAND LINE BUFFER ! 


OOPh 


! COMMAND LINE BUFFER POINTER ! 


0100 


1 MDOS VARIABLES, I 
! lOCBs and SYSTEM BUFFERS ! 




i SWI HANDLER 

\ KERNEL SYSTEM FUNCTIONS ! 




1 CONTRQI 1 FR DESCRIPTOR BLOCKS ! 




! SUPPORTED DEVICE DRIVERS ! 




! RESIDENT SYSTEM FUNCTIONS 1 




! OVERLAY HANDLER 1 




OVERLAY REGION 1 i 




1 OVERLAY REGION 2 '< 




! OVERLAY REGION 3 ! 


2000 


! OVERLAY REGION 4 ! 
; and *> 
! USER PROGRAM AREA I 



3FFF 



i END OF MINIMUM SYSTEM MEMORY 



ESOO 
EC 00 
FOOO 
FFFB 



END OF CONTIGUOUS MEMORY 
RAM Discontinuity 
NON-MDOS RAM 



DISKETTE CONTROLLER PROM 



PIAs 
EXbug MONITOR 
INTERRUPT VECTORS 
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Locations *0000-001F, inclusive. are reserved for the 
variables of the diskette controller. These locations cannot 
be initialized by a program loading from the diskette. In 
addition, if a program requires the use of the diskette 
functions (either directly throLsgh the diskette controller or 
through the MDOS functions), then these locations cannot be 
used by the program for storage. Locations $OOAE-OOFD, 
inclusive, contain the MDOS command line as it was entered by 
the operator. Command-interpreter-loadable programs must 
load above location SIFFF. They can use the direct 
addressing area for variable storage; however; this area 
cannot be initialized while the program is being loaded into 
memory. Programs that do not make use of MDOS system 
functions can load anywhere in memory above location SOOIF. 
If such programs do not use the diskette controller entry 

i_*._ /&»..a«W';v m. •f-ha rti-pprr addre^sina avea beloiii 

location $0020 can be used, but only after the program is 
resident in memory. 

The MDOS variables (locations «FE and , higher) contain 
pointers to several areas in memory that might be required by 
a user program. The absolute addresses of these pointers 
should be obtained from the MDOS equate file. The pointers 
most often required ars: 



Pointer Name 



Content 



CBUFP4 



The address in the command line 
buffer to the terminator of the 
command being executed. Parameters 
following the command name should be 
scanned for by using the contents of 
this variable. 



ENDOS* The address of the last location of 
resident MDOS. The value of this 
address plus one is the first 
location that a 

command-interpretei — loadab le program 
can load into. 



ENDUS* 



The address of the last location 
loaded into by the current program. 
The program can allocate additional 
memory (between the last loaded 
location and the end of contiguous 
memory) via one of the system 
functions. 



ENDSY* 



The address of the last 
contiguous memory (RAM). 



byte of 
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SWI«UV 



IRQ«UV 



The address of 
handler. This 
initialized by 
is using SUIs 



a user-defined SWI 

vector must be 

3 user program if it 

other than those 



defined far MDOS system functions. 
This vector is set to point to an RTI 
instruction each time the MDOS 
command interpreter is given control. 

The address of a user-defined IRQ 
handler. This vector must be 
initialized by a user program if it 
is using IRQs. This vector is set to 
point to an RTI instruction each time 
the MDOS command interpreter is given 
control- This vector is not 
availabale with MD0S09. 



24. 6 MDOS Command Interpreter 



The MDOS command interpreter is one of the MDOS overlays 
that gets control uthenever MDOS has been initialized or 
whenever a command has completed and returned control to 
MDOS. This overlay luill. cause the standard .command line 
input prompt (=) to be displayed whenever it is activated. 



If no valid file name 



Once in contfoli the interpreter waits for operator 
input. After a line has been entered, it is scanned for the 
first valid file name specification, 
is recognizedi the standard message 

WHAT? 



will be displayed and a new input pr 
encountered file name specificati 
name> it will be used to search the 
suffix "CM" and the default logical 
supplied by the MDOS command in 
explicitly entered by the operator, 
found in the directory specified by 
the "WHAT?" message shown above will 
input prompt shown. If the file nam 
the name of a file 
command-interpreter- loadable program 
be in the memory-image format and 
address that is greater than the val 
variable ENDOS* (greater that *1 
these tests, its contents are au 
memory and given control at the s 
contained in the file's RIB. 



ompt shown, 
on contains 
directory. 

unit number 
terpreter i 
If the fil 
the logical 

be displaye 
e is foundj 
that 
That is.- 
must have a 
ue contained 
FFF). If th 
tomatical ly 
tarting exec 



If the first 

a valid file 

The default 

zero will be 

f none are 

e name is. not 

unit number! 

d and another 

it must be 

contains a 

the file must 

starting load 

in the MDOS 

e file passes 

loaded into 

ution address 



The loaded program can then extract parameters from the 
MDOS command line buffer. The pointer into the buffer 
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(CBUFP*) was left pointing to the terminator that stepped the 
scan for the first valid file name specification when the 
MDOS command interpreter processed the input buffer. After 
completing its functioni the command can return to MDOS 
through one of the system functions (.MDENT) ushich 'jiill pass 
control back to the MDOS command interpreter, repeating the 
cycle. 

It should be noted here that commands invoked via the 
MDOS command interpreter do not necessarily have to have the 
suffix "CM" or reside on drive zero. If a user program with 
an "LD" suffix is being tested/ it can be loaded and executed 
directly from the command line (if it meets the requirements 
for command-interpreter-loadable programs) by explicitly 
entering the suffix after the file name. Similarly^ if a 
required command does not happen to reside on drive zeva, its 
name can be followed with a logical unit number to cause it 
to be looked for and loaded from the specifieu unit. For 
example, the command line 

DIR:2 

will invoke the directory command from drive two to display 
the directory of the diskette in drive zero. 

Whenever the MDOS command interpreter regains control 
after a command terminates, it checks that the diskette in 
drive zero still has the same parameters (version number, 
overlay RIB addresses) as the diskette used during the last 
MDOS initialization. If these parameters differ, one of the 
standard error messages EI, ER, EU, EV (Chapter 28) will be 
displayed and control given to the debug monitor. MDOS will 
then have to be reinitialized before the MDOS command 
interpreter will accept further commands. 

In addition, the following parameters avs reinitialized 
each time the MDOS command interpreter is given control. The 
user-defined SWI and IRQ vectors (SWI*UV and IRQ*UV) are 
reset to point to an RTl instruction. (Only SWI*UV is reset 
for MD0S09. ) Since the user program is no longer resident, 
the interrupt handlers are deactivated. The stack pointer is 
reset to the end of contiguous memory for the duration of the 
command interpreter's execution. The Error Status and Error 
Type parts of the system error status word are set or cleared 
depending on whether or not a valid command name was entered 
on the command line. 

24.7 Interrupt Handling 



When MDOS initializes, it saves the contents of the SWI 
vector required by - the debug monitor. The SWI and IRQ 
vectors are then changed to point into the MDOS function 
handler. Both vectors are required to allow the operator to 
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make full use of the debug facilities of the debug monitor 
while using MDOS system functions. Some versions of the 
M6a00 fiPU will give control to the address in the IRQ vector 
if an NMI occurs while an SWI is in progress. Since the 
debug facilities of the debug monitor use NMIi continuing 
from a system function call will result in passing control to 
the address in the IRQ vector. Thus, MDOS must intercept 
both SWI and IRQ interrupts; however* MDOS can distinguish 
the difference between this "pseudo-IRQ" and a real IRQ even 
though both give control to the same address. Since MDOS 
does not have any devices in the system that generate IRQ, 
there is no true IRQ interrrupt handler. User programs, 
however, can configure the MDOS variable IRQ«UV so that if a 
real IRQ occurs, the routine specified by the user will be 
given control. 

Such usei — defined IRQ handlers ars accessible as long as 
the MDOS command interpreter is not re-entered. Whenever 
control is returned to the MDOS command interpreter, the 
usei — defined IRQ vector will be changed to point back into 
MDOS. Thus, IRQs cannot occur after the user program has 
terminated. Otherwise, MDOS will hang up in a loop. This is 
to be expected, since MDOS has no way of knowing what device 
generated the IRQ, where the device is, or how to respond to 
the IRQ. An IRQ must not be pending or occur when the MDOS 
command interpreter is given control. 

Since the M6a09 MRU does not give control to the address 
in the IRQ vector if an NMI occurs while an SWI is in 
progress, MD0S09 handles IRQs in a slightly different manner. 
During initialization, the IRQ vector is set up so that if an 
IRQ occurs, control is returned to EXbug after printing an 
"EQ" error message. If the user wishes to incorporate his 
own IRQ handler, he should save off the current value in the 
IRQ vector location <the one set up by MDOS) nad then insert 
the address of his IRQ handler. Only then is it safer to 
allow IRQs. MDOS does not reset the IRQ vector if control is 
returned to it. Thus, the user must take responsibility for 
restoring the original value upon completion of its interrupt 
processing. 

For MDaS09, the FIRQ, SW12 and SWI3 vectors are handled 
in a similar manner. MD0S09 sets up these vectors so that 
the respective messages "EF", "ES" and "EW" are printed if an 
interrupt occurs prior to the user having set up his own 
interrupt handler. 

Certain precautions must be remembered if a user program 
is to process IRQs and use the MDOS system functions. Not 
all MDOS system functions are re-entrant, thus, SCALLs should 
not be- used in an IRQ handler. Also, the MDOS diskette 
controller runs with interrupts inhibited for the duration of 
any diskette access. Thus, regardless of whether a single 
sector or multiple sectors are being processed, interrupts 
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are inhibited throughout. Therefore, an IRQ cannot always be 
serviced within a definite time luindou) if diskette accesses 
can be in progress. The time is dependent on the length of 
the diskette access. 

Another potential problem exists if NMI is to be used 
while diskette functions are in progress. The Nlil vector is 
taken over by the diskette controller while the diskette 
access is in progress. The NMI is used as a tiroeout 
condition. Thus, if a user's system is generating NMIs while 
diskette accesses are going on. a timeout condition will 
result and the user will not be able to process the NMI. It 
is for this reason that no user-defined NMI vector is 
provided by MDQS. 

The system functions provided by MDOS are accessible 
thrcu''h use of the software interrupt or 3WI instruction. A 
full explanation regarding the MDOS SWIs is given in the next 
section; however. like the user-defined IRQ vector. MDOS 
allows a user-defined SWI vector to be configured through the 
variable SWI«UV. Like the user-defined IRQ handler, the 
usei — defined SWI handler is only accessible as long as the 
MDOS command interpreter is not reentered. Whenever control 
is returned to the MDOS command interpreter, the user-defined 
SWI vector will be changed to point back into MDOS. Thus, 
usei — defined SWIs cannot be processed after the user program 
has terminated. This is to be expected, since MDOS commands 
and user programs all load into one area of memory. Thus, 
the user-defined SWI handler is not resident after the MDOS 
command interpreter regains control. 

24.8 System Function Calls 

All of the system functions that MDOS commands use are 
also available to the user and can be incorporated into his 
program development. All MDOS system functions are accessed 
via the software interrupt or SWI instruction. Each SWI must 
be followed by a byte that contains the number of the 
function to be executed. MDOS's resident software interrupt 
handler can access up to 128 (decimal) functions; however. 
not all of these functions are defined. An error message 
will be printed if the software interrupt handler is 
activated and the function number is not defined. 

A special convention is used to allow the user to define 
a maximum of 128 functions also (to be processed by the 
user's software interrupt handler that is configured via 
SWI«UV). If the sign bit of the function number byte (bit 7) 
is set to one. a user-defined software interrupt is 
indicated. All MDOS software interrupts have function number 
bytes with the sign bit set to zero. The user-defined SWI 
handler gets control with the registers on the stack as if it 
intercepted the SWI directly. The B accumulator will have 
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the value of the function number (with the sign fait set to 
zero) to facilitate indexing into the user's function table. 

Since MDOS assumes control of the SWI vector which is 
normally used by EXbug* certain precautions must be observed 
when debugging programs using the debug monitor. 

i. MDOS must not be initialized via the debug 
monitor command "EBOOi G" or "MDOS" without first 
having depressed the ABORT or RESTART pushbuttons 
on the EXORciser's front panel. These two 
pushbuttons will restore EXbug's SWI vector. 

2. The normal breakpoints can be used while testing 
a program, regardless of whether MDOS system 
functions are used or notj howeverj breakpoints 
set bij simply placing an SWI instruction into 
memory via the memory change function will cause 
a system function to be executed rather than a 
breakpoint to occur. Breakpoints must only be 
set or cleared via the debug monitor commands. 

3. Breakpoints can be set on an SWI instruction that 
is an MDOS system function call; however, before 
continuing from that particular breakpoint with 
the ";P" or "i N" commands/- the breakpoint should 
be cleared (this is only true for the newer 
versions of the M6S00 MPU which do not give 
control to the IRQ vector when an NMI occurs 
while an SWI is executing). 

4. MDOS system functions cannot be traced or 
single-stepped through with the EXbug commands 
"iN" or ";T". Since these debug monitor 
functions utilize the stack, parts of MDOS will 
be overwritten due to the internal use of the 
stack pointer within the system function handler. 

MDOS system function calls or user-defined function 
calls are programmed by using the SWI instruction mnemonic 
and the FCB assembler directive. If programs are assembled 
with the MDOS eq.uate file (next section), the provided macro 
definitions with the names SCALL and UCALL can be used to 
generate the code for MDOS system functions and user-defined 
functions, respectively. The macros require an argument to 
be passed. This argument is the name or value of the 
function to be executed. The names of MDOS functions are 
assigned symbols in the MDOS equate file so that the use of 
absolute numbers is not necessary. Use of the SCALL or UCALL 
macro makes the program a bit easier to read, especially if 
. names ars used for the macro arguments. 

MDOS system functions receive their parameters in the y 
registers or in tables that ars pointed to by the registers. 
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Chapters 25 and 27 contain the detailed entry parameters and 
exit conditions for all MDOS system functions. 

Some system functions may not be able to perform their 
expected action. These functions will return an indication 
of whether a normal return or an abnormal return is being 
made. This condition is altuays passed back in the processor 
status (condition code) register. In additioni a status byte 
may be returned in one of the parameter tables or registers. 

Some of the more complex system functions involving 
input or output can encounter fatal error conditions as well 
as non-fatal error conditions. Fatal errors suggest that the 
program is hopelessly confused. In these casesr the only 
logical action is to display what the problem appears to be 
and to re-enter the MDOS command interpreter. Non— fatal 
errors can include such things as illegal record formats* 
checksum errors* file protection violation, lack of space on 
the diskette.- etc. Such conditions are noted and returned to 
the calling program. In these instances* it is the 
responsibility of the calling program to identify the source 
of the error and decide what the course of action should be. 

24.9 MDOS Equate File 



With each MDOS system diskette comes a file* EQU. SA, 
known as the MDOS equate file. The MDOS equate file contains 
the definitions of all symbols that ars required by the 
resident MDOS and all of the MDOS commands. Not all of these 
symbols will be required by the user* however* the file is 
left as is to make it as useful as possible. 

The MDOS equate file contains the follouiing definitions. 
The sequence of the descriptions more or less follows the 
sequence of the file from beginning to end. Four macro 
definitions avs found at the beginning of the MDOS equate 
file that are useful to the user. 

Macro Name Function 



SKIP2 To be used as an instruction. The 
effect of the instruction is to 
execute a branch to location *+3. 
The "*" refers to the address of the 
branch instruction. The condition 
codes are changed as in a CFX 
instruction; however, this branch 
instruction requires only one byte of 
memory. 

SKIPl To be used as an instruction. The 
effect of the instruction is to 
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SCALL 



UCALL 



execute a branch to location *+2. 
The condition codes are changed as in 
a BITA instruction; houieveri the 
branch instruction requires only one 
byte of memory. 

To be used u»ith a single argument to 
execute a software interrupt (SWI) to 
the MDOS systens function handier. 
This macro ensures that the sign bit 
of the function byte is set to zero. 
The symbols for the system functions 
ars defined later in the MDOS equate 
file. 

To be used with a single argument to 
execute a softuiare interrupt <SWI) to 
the usei — defined function handler. 
This macro ensures that the sign bit 
of the function byte is set to one. 
The UCALL macro only makes sense if 
the user has configured an SWI 
handler. 



All other macro definitions in the MDOS equate file 
internal use. 



are 



for 



Following the macro definitions i 
identifies all of the system functions 
SCALL macro (or an SWI instruction 
byte). These equates are defined using 
the labels to sequence themselves, 
removed from the list/ the numbers ass 
will still be consecutive) ascendin 
function is given the value of zero. 
are assigned a number one higher than 
If the SCALL macro is used in writ 
suggested that the system symbols fo 
also be used. 



s a list of names that 
accessible via the 

followed by a function 
a macro that allows 
Thus/ if one label is 

igned to the labels 

g integers. The first 
Subsequent functions 

the previous function. 

ing programs/ it is 

r the system functions 



After the definitions of the system function symbols is 
a set of equates for all of the ASCII control characters 
including space and rubout characters. These symbols are 
followed by equates for the special MDOS delimiters used for 
suffixes/ options/ logical unit numbers/ device names/ and 
family indicators. 

Next is a list of MDOS sector equates that defines where 
the various system tables are located. In addition. the 
sector size and the sectors/cylinder, etc./ are defined. 

Then/ offsets into the various system tables are 
defined. These equates are followed by the definitions of 
the fields in the I/O control block <IOCB)/ which, in turn, 
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are followed by another series of self-sequencing definitions 
for the various I/O function error statuses. 

Follouing the error statuses> the locations of all of 
the MDOS internal variables are defined. These include the 
locations of the variables needed by the user for accessing 
the command buffer* the memory sizes established at 
initialization, and the user-defined interrupt vectors. 

After the variables is a series of equates that defines 
the various bit positions of the IOCS, the offsets into the 
controller descriptor block (CDB)» bit definitions within the 
CDBi and the offsets to the entry points of the device 
drivers. 

Lastly, the diskette controller variables, entry points, 
and error statuses are equated to symbols. These eq^ustes ars 
followed by a partial list of the locations in EXbug required 
by MDQS. The EXbug equate list is not complete. Thus, users 
requiring other entry points into EXbug must provide them 
within their programs. 

If programs are being written th^t use the resident MDOS 
functions. it 'is suggested that the MDOS equate file be 
included as a part of the assembly (requires M6800 Macro 
Assembler). Symbols within the MDOS equate file may have 
their values changed by Motorola in subsequent versions of 
MDOSi however, all attempts will be made to ensure a minimal 
number of such changes. Therefore. the MDOS equate file 
should not be copied from one version of MDOS to another. 
Like the resident system and command files that comprise the 
operating system. the MDOS equate file is associated with a 
specific version and revision of the operating system. 

A listing of the MDOS equate file is contained in 
Appendix I. 
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25. INPUT/OUTPUT FUNCTIONS FOR SUPPORTED DEVICES 



In the -Following description of the I/O functions for 
supported devices these symbols uiill be used: 

Symbol Meaning 



A A accumulator 
B B accumulator 
X Index register 



Z Zero flag of condition code register (bit 

2) 
C Carry flag of condition code register 

<bit O) 
CR Carriage return 

It is assumed that the reader is familiar with what 
system functions are, hou they ars invoked, what precautions 
must be taken when testing programs using system functions, 
and how errors are handled by system functions (see section 
24.8). 

25. 1 Supported Devices 

MDOS provides input and output functions to access the 
following supported devices: 

MDOS Name Physical Device 



CN Console keyboard and/or display 

CP Console punch 

CR Console reader 

DK Diskette drive 

LP Line printer 

The following sections describe the system functions that are 
available for accessing these devices. 

25. 2 Device Dependent I/O Functions 

MDOS provides system functions for directly accessing 
the console keyboard, display, line printer, and diskette 
drives. All of the functions are accessed by executing an 
SWI instruction followed by a function byte. The value of 
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the function byte indicates the function to be executed and 
can be obtained from the MDOS equate file. All system 
functions that perform input/output operations require a 
stack in the user program area. The size of the stack must 
be at least SO bytes (decimal). Each system function call 
pushes seven bytes on the stack. Since function calls may be 
nested tuithin MDOS/ a large stack is required. It should be 
noted that EXbug does not have sufficient stack space 
availablei the stack area must be provided by the user 
elsewhere. 

The device dependent functions for the console and the 
line printer use the device independent functions (section 
25. 3 > via parameter tables held in the MDOS variable section 
of memory. Any error conditions detected by these system 

standard system error message to be displayed* and control to 
be given to the MDOS command interpreter. Since MDOS manages 
these parameter tables (reserving* opening* etc. )* any error 
except "Buffer Gverflou" during a console input mill be a 
fatal error. 

If* ujhile accessing the console or the line printer* the 
errors ars to be handled by the calling program* the device 
irfdependent I/O functions (section 25.3) must be used 
instead. 

25.2.1 Console input — . KEY IN 

The . KEYIN function inputs a specified number of 
characters from the system console keyboard. All characters 
entered (utith the following exceptions) ars stored into'an 
input buffer. The function does not return until a 
terminating carriage return is supplied from the keyboard. 

The following characters are treated as special control 
characters when encountered by the . KEYIN function: 

Character Value Function 



RUBOUT or DEL $7F Removes last character 

entered into buffer unless 
buffer is empty. The removed 
character is displayed on the 
system console to indicate 
that it has been removed from 
the buffer. No action occurs 
if the buffer is empty. 
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CTL-X or CAN *iS Deletes all characters from 

the input buffer. A carriage 
return/line feed is displayed 
on the console to indicate 
that a new input line must be 
entered. 

CTL— D or EOT $04 Displays the current contents 

of the input buffer from the 
first character to the last 
character entered. The input 
is not terminated. This 
feature offers a means of 
displaying a "clean" line 
after many characters have 



4-K< 



RUBOUT key. 



CTL-M or CR *0D Terminates the input. The 

carriage return is the last 
character placed into the 
input buffer. A carriage 
return/line feed is displayed 
on the console. 

All characters are normally echoed on the console display 
mechanism to indicate that they have been entered into the 
input buffer; houieyer/ the following characters are echoed 
but are not placed into the input buffer: 



Character 


Vail 


Null 


*00 


Line feed 


*OA 


DCl 


«11 


DC2 


*12 


DC3 


1513 


DC 4 


*14 



ENTRY PARAMETERS: B = The maximum number of characters to 

be input from the keyboard <not 
including the terminating CR). 
Characters entered after the maximum 
has already been input will not be 
echoed on the console.- nor will they 
be placed into the input buffer. If 
B = Oi then only a CR will be 
accepted from the keyboard. The 
function does not return until a CR 
is entered. 

X = The address of the input buffer that 
is to receive the data obtained from 
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EXIT CONDITIONS: 



the console key 
must be large eno 
one more charact 
in B. This ex 
provided for the 
return uhich is 
buffer. If X ha 
address . of the 
buffer. then a 
to ensure that B 
<decimal). If 8 
it mill be autotna 
79 to prevent th 
being overwritten 

A is indeterminate. 



board. The buffer 
ugh to accommodate 
er than is specified 
tra space must be 
terminating carriage 
placed into the 
ppens to contain the 

MDOS command line 

special test is made 

is less than SO 

is greater than 79> 
tically changed to 
e resident MDOS from 

ujith keyboard data. 



B = The number of characters input (not 
including the terminating CH ) . If B 
= 0. then only a CR mas entered. 

X is unchanged. 

CC is indeterminate. 

The input buffer contains the entered 
data, including the terminating 

carriage return. 



25.2.2 Check for BREAK key — . CKBRK 



The . CKBRK function examines the system ACIA for a 
framing error status, indicating that the BREAK key has been 
depressed since the last character was input from the console 
keyboard. This function also checks to see if the CTL-W key 
has been depressed. If the CTL-W is detected, the . CKBRK 
function will enter a loop waiting for any other character on 
the keyboard to be entered before returning to the calling 
program. 



ENTRY PARAMETERS: 
EXIT CONDITIONS: 



None. 

A. 3s and X registers are unchanged. 

C = 0. Z = 1 if no framing error (no 
BREAK key) is detected. The 
remainder of CC is indeterminate. 

C = 1. Z = if a framing error (BREAK 
key) is detected. The remainder of 
CC is indeterminate. 

No indication is returned concerning the CTL-W key. 
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This feature merely allows the operator 
pause the system. 



at the console to 



The f 
this functi 
subsequent 
keyboard. 
once witho 
successive 
each case 
once). As 
the BREAK 
system con 
character 
input reque 



raffling error cannot be cleared fr 
on. The framing error can only be 

reception of another character fr 
Thus/ if the . CKBRK function is call 
ut the ACIA having received any char 
calls» the framing sttot status is 

(even though the BREAK key utas 
a result' the BREAK key status is no 

key is depressed during an input re 
sole> since it is the reception 
that clears the framing error st 
st must be terminated uith a CR). 



om the ACIA by 
cleared upon 
□m the console 
ed more than 
acters betueen 

detected in 
depressed only 
t detected if 
quest from the 

of another 
atus (and each 



3"^ D T noocnla nii+Tnii+" — — 



n??Pi V. 



ne;pi x. 



ne^Pi 7 



The . DSPLY, . DSPLX 
display a specified c 
The function .DSPLY dis 
carriage return chara 
display strings that ar 
facilitating the use o 
string to output multip 
call. Both .DSPLY 
return/line feed sequen 
input or output is 
function does not send 
feed sequence so tha 
performed on the same 1 



, and . DSPLZ function 
haracter string on th 
plays a string that i 
cter. The functions 
e terminated by an 
f embedded carriage r 
le-line messages uii 

and .DSPLX will 
ce to the console so 
performed on a neui 
the terminating carr 
t subsequent input 
ine as the displayed 



s are all used to 
e system console, 
s terminated by a 
. DSPLX and . DSPLZ 
EOT character I 
eturns within the 
th one function 
send a carriage 

that subsequent 
line. The . DSPLZ 
iage return/line 

or output can be 
string. 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



X = The address of a displayable ASCII 
string. The string must be 
terminated by a carriage return (*0D> 
if using . DSPLY. Otherwisei the 
string must be terminated by an EOT 
(*04). The functions .DSPLX and 
.DSPLZ will convert embedded carriage 
return characters into carriage 
return/line feed sequences 
automatically. 

A and B registers are unchanged. 

X = The address of the string 's 
terminating character. 

CC is indeterminate. 
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25.2.3.1 Example of console I/O 

The following example illustrates the use of the . KEYIN 
and . DSPLY system functions. The example initially displays 
a message on the console to prompt the operator for input. 
The entered string is then displayed back on the console, but 
all characters have been reversed (the last character input 
is the first character output, etc. ). If only a carriage 
return is entered. MDOS is given control via the system 
function . MDENT. The system function . ADSX is used to add 
the contents of the B accumulator to the X register. Both of 
these functions are described in Chapter 27. A maximum 
string length of ten is allowed. The example has been 
assembled with the MDOS equate file. 

It is assumed in this example that the program is 
origined above location 5iFFF since it is using the resident 
MDOS functions. The program can either be loaded with the 
LOAD command or invoked from the MDOS command interpreter 
directly. At the time the program is loaded, the stack 
pointer is automatically initialized to the last-loaded 
program location. In this example, this location is used as 
the top of the stack. 



.J 
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Device Dependent I/O Functions 



SHOW INPUT PROMPT 



START LDX #PROIiPT 

SCALL . DSPLY 
* 

* INPUT THE STRING FROM CONSOLE 
* 

INPUT LDAB #10 . MAX 10 CHAR 

LDX # I BUFF 

SCALL . KEY IN 

TSTB 

BNE SWAP 

SCALL . MDENT 
» 

* INVERT STRING INTO OBUFF 

SCALL . ADBX 
#CR 
X 



LOOP 



LDAA 

STAA 

DEX 

STS 

LDS 

PULA 

STAA 

DEX 

DECS 

BNE 

LDS 

LDX 



STKSAV 
#IBUFF-1 



LOOP 

STKSAV 

#OBUFF 



SCALL . DSPLY 
BRA INPUT 



GET INPUT STRING 
CHECK FOR ZERO INPUT 

EXIT IF NO INPUT 



POINT TO END OF OBUFF 
STORE TERMINATOR 



SAVE STACK POINTER 

GET CHAR 
STORE CHAR 
BUMP POINTER 

LOOP UNTIL ZERO 
RESTORE STACK 

SHOW INVERTED STRING 



10+1 
10+1 



* WORKING STORAGE 

» 

IBUFF BSZ 

OBUFF BSZ 

PROMPT FCC 

FCB 
STKSAV FDB 

BSZ 
» 

END 



. INPUT BUFFER 

. OUTPUT BUFFER 
"ENTER STRINGS < 11 CHARACTERS" 
CR 

. SAVE AREA 
SO . STACK SET HERE BY LOAD 



START . BEGIN EXECUTION AT THIS LABEL 
25. 2. 4 Printer output — . PRINT, . PRINX 



The .PRINT and .PRINX functions are both used to print a 
specified character string on the line printer. The function 

■ • string that is terminated by a carriage 

The function .PRINX prints a string that 
is terminated by an EOT character, facilitating the use of 
carriage returns within the string to print 
multiple-line messages with one function call. Both 
functions wiil send a zsvvisge return/line feed sequence to 



PRINT prints a 
return character, 
is ten 
embedded 
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the printer at the end of each string. The . PRINX function 
oiilli in additioni send a carriage return/line feed sequence 
for each embedded carriage return character. 

ENTRY PARAMETERS: X = The address of a displayable ASCII 

string. The string must be 
terminated by a carriage return CSOD) 
if using .PRINT. Otherwise. the 
string must be terminated by an EOT 
($04). The .PRINX function will 
convert embedded carriage return 
characters into carriags return/line 
feed seq,uences automaticallij. 

EXIT CONDITIONS: A and B registers are unchanged. 

X = The address of the string's 
terminating character. 

CC is indeterminate. 

25. a. 4. 1 Example of printer output 



The following example illustrates the use of the .PRINT 
system function. The example will print strings, of eighty 
identical characters, beginning with spaces (*20) and 
proceeding through the entire displayable ASCII character 
set. The system function . STCHR is used to fill a buffer 
with the character contained in the A accumulator. The 
system function . MDENT is used to return control to MDOS. 
Both of these functions ars described in Chapter 27. The 
example was assembled with the MDOS equate file. 

It is assumed in this example that the program is 
origined above location $1FFF since it is using the resident 
MDOS functions. The program can either be loaded with the 
LOAD command or invoked from the MDOS command interpreter 
directly. At the time the program is loaded/ the stack 
pointer is automatically initialized to the last-loaded 
program location. In this example, this location is used as 
the top of the stack. 
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START LDAA tSPACE 

LOOP LDX #OBUFF 

LDAB #80 

SCALL . STCHR 

SCALL .PRINT 
INC A 

CMPA #RUBOUT 

BNE LOOP 

SCALL . MDENT 



INITIAL CHAR 



FILL BUFFER 

PRINT THE STRING 

BUMP CHARACTER 

END OF DISPLAYABLE SEQUENCE 

EXIT TO MDOS 



» WORKING STORASE 

# 

OBUFF BSZ 80 

FCB CR 

BSZ SO 

* 

END START 



. OUTPUT BUFFER 

'. STACK SET HERE BY LOAD 

. BEGIN EXECUTION AT THIS LABEL 

25.2.5 Physical sector input — .DREAD. . ERE AD 



The .DREAD and . EREAD functions are both us 
single physical sector from the diskette int 
buffer. For multiple physical sector input the 
section 25.2.7 should be used. The .DREAD funct 
return to the calling program if no diskett 
errors are detected during the read attempt 
function, on the other handi will return to 
program whether an error occurred or not. 
function mill return the error status that was 
the diskette controller-. 



ed to read a 

o a specified 

functions in 

ion will only 

e controller 

The . EREAD 

the calling 

The .EREAD 

detected by 



In either case. if a diskette error occurred that was 
retryable (CRC, deleted data mark, data address mark. or 
address mark CRC errors), the following steps were taken in 
an attempt to recover from the error: 



The sector was reread five 
repositioning the read head. 



times 



without 



The read head was stepped outward (towards 
cylinder zero) a maximum of five cylinders, 
repositioned over the cylinder in which the 
sector to be read resides, and another five read 
attempts were performed. 

The read head was stepped inward (towards 
cylinder 76) a maximum of five cylinders, 
repositioned over the cylinder in which the 
sector to be read resides, and a.nother five read 
attempts were performed. 



If 



an 



error occurs during the . DREAD function, the 
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standard "PROM I/O" error message mill be displayed giving 
the status of the error and the sector number that uias being 
accessed. Control uiill then be given to the MDOS command 
interpreter. If an error occurs during the . ERE AD function, 
the EXIT CONDITIONS described below apply (for C = 1). 

If either of these tuio functions is to access a diskette 
in a drive which as not had the read head restored (via 
functions .DIRSM, .OPEN. . LOAD or .CHANG. or via an MDOS 
command). then the diskette controller firmware must be 
invoked to restore the head. The RESTOR entry point is 
described in Appendix D. If the head is not restored 
properly, it is possible to receive timeout errors. 

The diskette controller variables below location *0O20 
will be changed by these functions. 

ENTRY PARAMETERS: B = The logical unit number. Bits 2-7 

are ignored. 

X = The address of a five-byte I/O 
parameter packet. The packet has the 
fallowing format: 




1 
2 
3 
4 



I Return status ! 


I Physical sector ! 
— number — 
1 to be read 1 


! Address of 128 1 
— byte 

! sector buffer 1 



EXIT CONDITIONS: 



C = 



if no errors occurred. The 
remainder of the CC is indeterminate. 

The A register is indeterminate. 

The X register is unchanged. 

The B register contains the return 
status returned in the packet C*30). 

The first byte of the parameter 
packet (Return Status) is set to $30 
(ASCII zero). The remainder of the 
parameter packet is unchanged. 

The sector buffer contains the 128 
bytes read from the specified 
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physical sector. 

C = i if an error occurred {.EREAD only). 
The remainder of the CC is 
indeterminate. 

The A register is indeterminate. 

The X register is unchanged. 

The B register contains the retLfrn 
status returned in the first byte of 
the parameter packet. 

The first byte of the parameter 

controller error ($31-«39). Section 
28. 1 has a complete description of 
the diskette controller errors. 

The contents of the 128 byte sector 
buffer are indeterminate. 

25.2.6 Physical sector output — . DWRIT.- . EWRIT 

The .DWRIT and .EWRIT functions are both used to write a 
single physical sector to the diskette from a specified 
buffer. For multiple physical sector output the functions 
described in section 25.2.8 should be used. The .DWRIT 
function will only return to the calling program if no 
diskette controller errors are detected during the write 
attempt. The .EWRIT function, on the other hand, will return 
to the calling program whether an error occurred or not. The 
.EWRIT function will return the error status that was 
detected by the diskette controller. 

If an error occurred/ the same type of recovery 
procedure described in section 25.2.5 (.DREAD, .EREAD) was 
attempted. In addition, the same precautions described for 
those functions regarding the restoring of the read head 
apply to the .DWRIT and .EWRIT functions. 

ENTRY PARAMETERS: Same as for .DREAD and . EREAD i however, 

the sector buffer must contain the 
128 bytes that ars to be written to 
the diskette. 

EXIT CONDITIONS: Same as for .DREAD and .EREAD; however, 

the the contents of the sector buffer 

are unchanged after returning to the 
calling program. 
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25.2.7 Multiple sector input — . MREAD. . MERED 



--■N 



The .MREAD and .MERED functions are both used to read a 
multiple number of physically contiguous sectors from the 
diskette into a specified buffer. The .MREAD function will 
only return to the calling program if ne diskette controller 
errors are detected during the read attempt. The .MERED 
functioni on the other hand. will return to 
program whether an error occurred or not. 
function will return the error status that was 
the diskette controller. 



the calling 

The .MERED 

detected by 



If an error 
procedure described 



occurred. the same type of recovery 
in section 25.2.5 <. DREAD. . EREAD) was 
attempted. In addition, the same precautions regarding the 
restoring of the read head described in that section apply 
the .MREAD and .MERED functions. 



to 



ENTRY PARAMETERS; 



B = The logical 
are ignored. 



unit number. Bits 2-7 



X = 



The address of a seven-byte I/Q 
parameter packet. The parameter 
packet has the following format: 




1 
2 
3 
4 
5 
6 



! Return 


status ! 


I Starting 


physical 1 


— sector 


number — 


! to be 


read ! 


1 Address of i 


— multiple — 


! sector 


buffer 1 


• Number of ! 


— sectors — 


1 to be 


read 1 



The sector buffer must be an integral 
number of sectors in sizei and must 
be large enough to accommodate the 
number of sectors specified in bytes 
5 and 6 of the parameter packet. 



EXIT CONDITIONS: 



Same as for . DREAD and . EREADj however, 
the sector buffer contains data from 
the number of sectors specified in 
bytes 5 and 6 of the parameter packet 
(only if no error occurred). 
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25.2.8 Multiple sector output — . MWRITi . MEWRT 

The . MWRIT and .MEWRT functions are both used to write a 
multiple number of physically contiguous sectors from a 
specified buffer to the diskette. The .MWRIT function will 
only return to the calling program if no diskette controller 
errors are detected during the write attempt. The .MEWRT 
functioni on the other handi will return to the calling 
program whether an error occurred or not. The . MEWRT 
function will return the error status that was detected by 
the diskette controller. 

If an error occurred; the same type of recovery 
procedure described in section 25.2.5 (.DREAD* . EREAD) was 
attempted. In addition, the same precautions regarding the 
restoring of the rsad head described in that section apply to 
the .MWRIT and .MEWRT functions. 

ENTRY PARAMETERS: Same as for . MREAD and . MERED; however. 

the sector buffer must contain the 
bytes that are to be written to the 
diskette. 

EXIT CONDITIONS: Same as for .MREAD and .MERED; however. 

the contents of the sector buffer are 
unchanged after returning to the 
calling program. 

25.2.9 Diskette controller entry points 



The diskette controller has various entry points that 
allow the diskette to be accessed on a physical sector basis; 
however, since these entry points are independent of MDOS. 
they are described in a separate section (Appendix D). That 
appendix also describes some entry points for accessing the 
line printer on an MDOS-independent basis. 

25.3 Device Independent I/O Functions 

The following sections describe functions which 
facilitate writing software for input/output operations 
independent of the physical hardware device. In addition, 
these functions are used to access files on the diskette 
without having to perform physical sector 1/0. 

Through the use of a single parameter table, the I/O 
Control Block or IOCS, a common set of functions can be 
accessed independently of the I/O device. Thus, the same 
function would be called for writing a record to a diskette 
file or for writing a record to a line printer. The only 
difference is in the initial parameterization of the IOCS. 
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The normal sequence for calling the I/O functions, 
regardless of the device being used* is: 

. RESRV Reserve a device 

. OPEN Open a file 

. GETRC Read a record 

. PUTRC Write a record 

. CLOSE Close a file 

. RELES Release a device 

The reading/uiriting of records, of course, may not 

necessarily be used for the same device. Once the file is 

open, the record I/O functions can be called as many times as 
required. 

M-a gf 4;}59 rfsyiro independent I/O functions uiill cause 
the diskette controller variables below location *0O20 to be 
changed, regardless of whether or not a diskette device is 
being used for a given I/O process. 

In order to fullij describe each device independent I/O 
function, the structure of the IOCS must first be described. 
In the description of the errors that can be returned by each 
function, the names of the system symbols from the MDOS 
equate file ars used. These ars noted in the description of 
the status byte of the lOCB, section 25.3.1.1. A summary of 
all possible input parameters that are required by the twelve 
different modes in which an IDCB can be used is contained in 
Appendix K. 

25.3. 1 I/O Control Block — IOCS 



The device independent I/O functions ars parameterized 
through the lOCB. The I/O functions, in turn, interface to a 
device driver through another table, the Controller 
Descriptor Block or CDB (see section 26.2). It is only the 
device driver which interfaces directly to the device. 

The IOCS is a table of flags, buffer pointers, and other 
information which is maintained by the calling program for 
the duration of the I/O accesses that are to be performed. 
Some of the entries in the IOCS must be initialized by the 
program before calling an I/O function. Other entries of the 
IOCS are initialized and changed by the I/O functions 
themselves. The entries of the lOCB must not be changed 
between I/O accesses unless specifically indicated in the 
ENTRY PARAMETERS section of each I/O function's description. 
The lOCB has the following format: 



"^ 
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Byte 



< — Bit position 



00 




Error status > 


lOCSTA 
lOCDI 1 

IDCDBP 

lOCDBS 

lOCDBE 

lOCGDW 
lOCLUN 
IDCNAM 

lOCSDW 

lOCSLS 

lOCLSN 

IQCSUF 

lOCRIB 

lOCFDF 


/ 

/ 




01 




10 ISIOITIF! M I 


Data transfer 
typ^e 


02 

03 




Data buffer ! 
pointer — 


04 
05 




Data buffer 1 
start address — 




06 
07 


— 


Data buffer I 
end address 




08 
09 


— 


Generic device word ! 

or — 

CDB address ! 




OA 




! R ! LUN 


- Logical unit 
number 

lOCMLS 


OB 
OC 


— 


File name ! 

or — 

Maximum LSN referenced 1 


OD 
OE 


1 File name continued ! 
— or — 
ICurrent segment descriptor mord ! 




OF 

10 


— 


File name continued I 

or 
Starting LSN of SDW ! 




11 
12 


— 


File name continued ! 

or — 

Next logical sector number I 




13 

14 


— 


Suffix i 

or — 

Logical sector number of EOF ! 


IDCEDF 


15 
16 


— 


Physical sector number ! 
of file's RIB 




17 
18 


— 


W ! D I S 1 C I N 1 FMT ! 
(reserved; =0) ' 


File descrip- 
tor flags 
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19 




(reservedi ==0) — 






lA 






IOC DEN - 




ID 




PSN 1 EN ! 


- Diractory 
entry number 


IC 




(reserved! =0) ' 






ID 




Initial new file size 

or — 


- lOCSBP 




IE 




Sector buffer pointer 






IF 




Sector buffer 

start address — 


- I0C3B3 




20 










21 


! 


Sector buffer 
end address- — 


- IDCSBE 




22 


! 




1 

- IQCSBI 




23 


1 


Sector buffer 
internal pointer ~ 




24 


f 

1 




1 

f 





.^ 
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lOCB FLAG DESCRIPTION SUMMARY 



Field Name Bit 



Content 



lOCDTT 10 6-7 



S 5 



4 



T 3 



F 2 



M 0-1 



IQCLUN - 7 
R 6 



LUN 0-5 
lOCFDF W F 

D E 

S D 

c c 

N B 



I/O tra 
Bit 
Bit 

Sector/ 

= 

1 =: 

Open/cl 

= 

1 = 
Truncat 

= 

1 = 
Non-fil 

= 

1 = 
Mode fl 

00 
01 
10 
11 



nsfer flag 
6: 1 => Output transfer 
7: 1 => Input transfer 

record flag 

> Record I/O 

> Sector I/O 
osed flag 

> File open 

> File closed 
e flag 

> Ignore truncate action 

> Truncate file upon closing 
e format flag 

> File format mode 

> Non— file format mode 



ag 

=> Update mode, existing file 
=> Input mode, existing file 
=> Output mode, new file 
=> Update mode, any file 



Not used (=0) 
Reserved flag 

=> lOCB released 

1 => lOCB reserved 
Logical unit number («30-«39) 

Write protection bit 

=> No write protection 

1 => Write protected 
Delete protection bit 

=> No delete protection 

1 => Delete protected 
System file bit 

=> Non-system file 

1 => System file 
Contiguous allocation bit 

=> Segmented allocation 

1 => Contiguous allocation 
Non-compressed space bit 

=> Spaces compressed 

1 => Spaces non-compressed 
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lOCB FLAG DESCRIPTION SUMMARY continued 



"^ 



Field Name Bit 



Content 



lOGFDF FMT 8- A 



0-7 



File format 

000 => User-defined format 

001 => Use device's default format for 

binary records 
010 => Memory-image format 
Oil => Binary record format 

100 => Undefined format 

101 => ASCII record format 
110 => Undefined format 

ill => ASCI I— converted-b inary reeord 

format 
Not used (=0) 



lOCDEN PSN B-F 

EN 8-A 

0-7 



Physical sector number ($03-16) 
Entry number luithin sector (0-7) 
Not used (=0) 



25.3. 1. 1 lOCSTA — Error status 



The lOCSTA byte contains the return status from an I/O 
function. A zero in this byte indicates that an I/O function 
completed normally without any errors. A non-zero value 
indicates that an I/O function encountered some sort of an 
error. The following table contains all of the currently 
defined values that can be returned in the lOCSTA. Along 
with each value the system symbol equated to the value (MDOS 
equate file). and the standard error message that tuould be 
displayed if the error message function mere invoked to show 
a message are given. The tuio-digit reference number 
displayed along with the error message should be used to 
locate the error message's description in Chapter 23. It 
should be noted that in order to decode the lOCSTA byte into 
the proper error messagej the error message function. . MDERR» 
must be called with the B accumulator equal to zero. Section 
27.4 describes the error message handler. 
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lOCSTA System Standard Error Message Displayed 
Value Symbol by . MDERR (B=Of X=IOCB address) 



00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 

OE 

OF 

10 

11 

12 
13 

14 
15 

16 
17 



le 

19 



I*NOER 

I*NODV 

I«RESV 

I$NORV 

I*NRDY 

I«IVDV 

ISDUPE 

I^NONM 

I»CLaS 

I*£OF 

I*FTYP 

I SDTYF 

I*EOM 

I*BUFO 

I *CKSM 

I*WRIT 

I*DELT 

I$RANG 

I*FSPC 
I*DSPC 
I «SSPC 
I*IDEN 

I*RIB 
I*DEAL 



I*RECL 
I«SECB 



Normal 
#* 28 

*» le 

** 1? 
♦* 11 

*« 31 
** 06 
»» 04 
** 20 

** 21 
** 14 
** 17 
** 37 
** 22 
** 23 
«■* 26 
*♦ 10 
*# 24 

** 41 

*# 40 

** 42 

** 43 

** 32 
#* 44 



** 45 
** 52 



return, no error 
DEVICE NAME NOT FOUND 
DEVICE ALREADY RESERVED 
DEVICE NOT RESERVED 
DEVICE NOT READY 
INVALID DEVICE 
DUPLICATE FILE NAME 
FILE NAME NOT FOUND 
INVALID OPEN/CLOSED FLAG 
END OF FILE 
INVALID FILE TYPE 
INVALID DATA TRANSFER 
END OF MEDIA 
BUFFER OVERFLOW 
CHECKSUM ERROR 
FILE IS WRITE PROTECTED 
FILE IS DELETE PROTECTED 
LOGICAL SECTOR NUMBER OUT OF 

RANGE 
INSUFFICIENT DISK SPACE 
DIRECTORY SPACE FULL 
SEGMENT DESCRIPTOR SPACE FULL 
INVALID DIRECTORY ENTRY NO. AT 

nnnn 
INVALID RIB 
CANNOT DEALLOCATE ALL SPACE. 

DIRECTORY ENTRY EXISTS AT 

nnnn 
RECORD LENGTH TOO LARGE 
SECTOR BUFFER SIZE ERROR 



25. 3. 1. 2 lOCDTT — Data transfer type 



The lOCDTT byte contains the basic information about an 
I/O access: whether an input or an output transfer is to 
take place, whether sector or record I/O is to be performed, 
whether the file is currently open or closed, whether a file 
(diskette only) should be truncated when it is closed, and 



whether the 



.e or non— file format mode is to be used. 
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The format of the lOCDTT byte is shown below: 



IQ 



Mode flag 

Non-file format flag 
Truncate flag 
Open/closed flag 
Sector /record flag 
I/O transfer flag 



Regardless of the type of device being accessed, the 
non-file format flag (F) and the mode flag (li) are to be 
initialized by the user. If the device is a diskette drive, 
the user may also change the sector/record flag <S) or the 
truncate flag <T) between I/O function calls. If the flags 
ave to be changed after the IQCDTT byte has been initialized, 
care must be taken so that none of the system supplied flags 
are destroyed. Flags must be "or-ed" into the lOCDTT to be 
set, and "and-ed" out of the lOCDTT to be cleared, once 
IQCB has been reserved. 



the 



The properties controlled by the various bits of the 
lOCDTT are explained below. 

10 (Bits 6-7) — I/O transfer flag 

These two bits are controlled exclusively by the 
I/O functions themselves. They should not be set or 
changed by the user in any case. If bit 6 is set to 
one, the device driver recognizes an output transfer. 
If bit 7 is set to one, the device driver recognizes 
an input transfer. The device driver will not be 
able to input or output a character if both of these 
bits are zero or one. 



-^ 
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S (Bit 5) Sector/record flag 

This bit controls whether sector or record 
processing is performed during an I/O function. For 
non-diskette devices* this bit must always be zero. 
For diskette devices* this bit can be in either 
state. A one implies that logical sector I/O will be 
performed. A zero implies that record I/O will be 
performed; howeveri cars must be taken that the 
corresponding I/O function is called for the proper 
state of the bit. That is. the record I/O functions 
<.GETRC and . PUTRC) cannot be called if "S" is set to 
one. Likewise. the logical sector I/O functions 
(.GETLS and . PUTLS) cannot be called if "S" is set to 
zero. 

This bit is supplied by the system I/O functions 
if they are properly called in their correct 
sequence. The "O" bit must not be changed once I/O 
transfers have been made. A one indicates that the 
file (or device) is closed. A zero* on the other 
handi. indicates that the file (or device) is open. 

T (Bit 3) — Truncate flag 

The truncate flag is only applicable to I/O on a 
diskette device. Normally, the user will not have to 
set or change this bit; however, certain cases will 
arise where changing of the truncate flag by the user 
may be necessary (see .CLOSE function. section 
25.3.6). The truncate flag is used as an indication 
that new space was allocated to a diskette file. If 
it is set to one. any unused parts of the newly 
allocated space (space beyond the maximum logical 
sector number referenced in lOCMLS) will be 
deallocated (returned to the available diskette 
space) when the file is closed. If the truncate flag 
is zero, no truncation will occur upon closing. 

A special case exists if lOCMLS contains the 
value «FFFF when the truncate flag is set to one. In 
addition to having all of the file's space, 
deallocated, the directory entry belonging to the 
file is removed from the directory. The file is, in 
effect, deleted. 
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F (Bit 2) — Non— file format flag 

If "F" is set to OTt©i the non-file format mode 
is indicated. In this mode, all I/O must be to a 
non-diskette device. No FDR (File Descriptor Record) 
processing is performed. The only valid file format 
that can be supported in this mode is ASCII (FMT = 5 
of lOCFDF). 

If the "F" flag is set to zero. then the file 
format mode is indicated. In this mode/ I/O can be 
either to a diskette or to a non-diskette device. If 
a non-diskette device is being usedi FDR processing 
will be performed. That iS/ an FDR uill be written 
to the device if opened for output, or an FDR will be 

» ..^ -.««.• u nW £mw Mm 4-ha AAKj-ifa iH nnar\ati ^n-n -irknil-t? Th O 

file format mode (F = 0) must be used for accessing 
the diskette. 

M (Bits 0-1) — Mode flag 

The mode flag can take on one of four different 
values: 

00 => Open an existing file (diskette only) for 
• either input or output. 

01 => Open an existing diskette file or open a 

device for input only. 

10 => Create a new diskette file or open a device 

for output only. 

11 => Open an existing file or create a new file 

(diskette only) for either input or output. 

The update modes (M = 00 or 11) can only be used 
when accessing diskette files. The way in which the 
four different modes are used is described in the 
.OPEN function, section 25.3.3. 

25.3. 1.3 lOCDBP — Data buffer pointer 



This two-byte field of the lOCB is used as a working 
storage area by the record I/Q functions. This entry should 
not be changed by the calling program once I/O functions have 
been called. 

25. 3. 1. 4 lOCDBS — Data buffer start 



This two-byte field of the IOCS must be initialized by 
the calling program before any record I/O functions are 
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called. lOCDBS must be configured to contain the address of 
the first byte of a buffer into which a record is to be read/ 
or froas which a record is to be written. None of the I/O 
functions will alter lOCDBS. The data buffer may be used for 
FDR processing by the . OPEN function (section 25. 3. 3) when 
dealing with non— diskette devices. 

25. 3. 1. 5 IQCDBE — Data buffer end 



This two-byte field of the lOCB must be initialized by 
the calling program before any record I/O functions are 
called. lOCDBE must be configured to contain the address of 
the last byte of a buffer into which a record is to be read* 
or from which a record is to be written. During record 
inputs lOCDBS and lOCDBE define the maximum size record that 
the buffer can accommodate. During record output* lOCDBS and 
lOCDBE describe the first and last byte of the record to be 
written. None of the I/O functions will alter lOCDBE. The 
data buffer may be used for FDR processing by the .OPEN 
function (section 25.3.3) when dealing with non-diskette 
devices. 

25.3.1.6 lOCGDW — Generic device word 



This two-byte field of the lOCB serves a dual function. 
Before any I/O functions can be invoked. lOCGDW must contain 
the MOOS device name that is to be accessed (see section 
25.1). The device name consists of two ASCII characters. 
Once the . RESRV function (section 25.3.2) has been called, 
lOCGDW will contain the address of the controller descriptor 
block (CDB. section 26.2.1) associated with that device. 
After the CDB address has been put into lOCSDW, the contents 
of this field must not be changed by the calling program. 
Section 26. 2 contains a description of how to configure the 
lOCGDW field for non-supported devices. 

25.3. 1.7 lOCLUN — Logical unit number 



The lOCLUN byte contains two pieces of information. 
Initially* the calling program must store the logical unit 
number of the device to be accessed in this byte. The 
logical unit number identifies a specific device within a 
generic device family (e.g., drive zero of the family DK>. 
If there is only one device in a generic device family, a 
logical unit number of zero must be placed in lOCLUN. 
Logical unit numbers should be ASCII numbers in the range 
*30-*39 (0-9). Bit "R" of lOCLUN indicates whether or not 
the lOCB has been reserved (.RESRV function). Initially, 
when the logical unit number is stored in lOCLUN, bit "R" 
will be set to zero. After the .RESRV function has been 
successfully invoked, bit "R" will be set to one, indicating 
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that the IOCS has been reserved. The lOCLUN field must not 
be changed by the calling program after the . RESRV function 
has been called. 

25.3. 1.8 lOCNAM — File name 



These eight bytes of the IOCS serve a dual purpose. If 
the non-file format mode is being used (F = 1 of lOCDTT). 
laCNAM is not used at allv however/ in the file format mode^ 
lOCNAM must contain the name of the file to be accessed. The 
file name must be in the valid HDDS file name format. Any 
unused parts of the name must be spaces (*20). The file name 
should be placed into lOCNAM before the . GPEN function is 
invoked. After a file has been opened/ the eight bytes will 
be replaced with the four two-byte fields lOCMLSi lOCSDWi 
IQCSLS/ and lOCLSN (only if the device is diskette). 

When dealing with non-diskette devices in the file 
format mode/ the lOCNAM entry can be configured so that the 
first byte is a binary zero. In this case/ the .OPEN 
function will search for the first FDR on the non-diskette 
device/ and. place the found file name (and suffix) into 
lOCNAM (and lOCSUF). 

25.3. 1.9 lOCSUF — Suffix 



This two-byte field of the lOCB serves a dual purpose. 
If the non-file format mode is being used (F = 1 of lOCDTT)/ 
lOCSUF is not used at all; however/ in the file format mode/ 
lOCSUF must contain the suffix of the file to b.e accessed. 
The suffix must be in the valid MDOS suffix format. Any 
unused parts of the suffix must be spaces ($20). The suffix 
should be placed into IDCSUF before the .OPEN function is 
invoked (at the same time that the file name is placed into 
lOCNAM). After a file has been opened/ IQCSUF will be 
replaced with the two-byte field lOCEOF (only if the device 
is diskette). If the device being accessed is the system 
console/ the first character of the IQCSUF field may be 
changed by the user to a displayable ASCII character 
(*aO-45F). Then/ whenever an input request is made on that 
device/ the character will be displayed as an input prompt. 

When dealing with non-diskette devices in the file 
format mode/ the lOCNAM entry can be configured so that the 
first byte is a binary :ero. In this case, the .OPEN 
function will search for the first FDR on the non-diskette 
device/ and place the found file name (and suffix) into 
lOCNAM (and lOCSUF). 



y 
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25.3. 1. 10 lOCMLS — Maximum LSN referenced 



This two-byte field 
bytes of the lOCNAM after t 
(diskette I/O only). It 
contains the maximum logica 
any of the I/O functions. 
lOCDTT) are used in determi 
diskette space that is to 
is closed. Space will only 
flag is set to a one. 
truncate flag to a one if n 
a file< any unused spac 
available space pool. 



of the IOCS overlays the first two 

he .OPEN function has been called 

is a system-maintained field that 

1 sector number ever referenced by 

lOCMLS and the truncate flag <T of 

ning the amount of newly allocated 

be deallocated from a file itfhen it 

be deallocated if the truncate 

Since MDOS automatically sets the 

ew diskette space is allocated to 

e ufill always be returned to the 



truncate flag in the IQCDTT since the truncate flag is 
automatically set whenever additional space allocation is 
performed or whenever a new file is created. When accessing 
an existing file using both input and output (M = 00 or 11 of 
lOCDTT); howeveri the truncate flag may have to be set to one 
by the user if the file is to be shortened or if the 
end-of-file pointer in the RIB is to be updated. If an 
extant file does not grow in size* the truncate flag will be 
zero. 



In addition. when files are 
subsequent .CLOSE function cali)/ the 
value of SFFFF and the truncate flag 



to be deleted (upon a 
lOCMLS must be set to a 
must be set to one. 



25. 3. 1. 11 lOCSDW — Current SDW 



The lOCSDW field overlays the second two bytes of lOCNAM 
after the .OPEN function has been called (diskette I/O only). 
This field contains the segment descriptor word which 
identifies the current file segment that can be accessed. If 
another segment of the file is to be accessed, the disk 
driver will automatically reread the file's RIB and extract 
the appropriate SDW into lOCSDW. The contents of lOCSDW 
should never be changed by the calling program. 

25. 3. 1. 12 lOCSLS — Starting LSN of SDW 



The IQCSLS field overlays the third two bytes of lOCNAM 
after the .OPEN function has been called (diskette I/O only). 
This field contains the starting logical sector number of the 
current segment descriptor word. The contents of I0CSL5 
should never be changed by the calling program, 
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25.3. i. 13 lOCLSN — Next LSN 



The lOCLSN field overlays the fourth two bytes of lOCNAM 
after the .OPEN function has been called (diskette I/O only). 
This field is never changed by the calling program if record 
I/O <S - of lOCDTT) is being used. If logical sector I/O 
is being used (S = 1 of lOCDTT), then lOCLSN can be changed 
by the calling program to specify uihich logical sectors are 
to be read from or written to the file. This feature allows 
the calling program to randomly access the file (by logical 
sector number) without having to know physically where the 
file resides on the diskette. After an I/O access has been 
completed.- lOCLSN will contain the logical sector number of 
the next sector on the diskette to be accessed. When using a 
multiple sector buffer* lOCLSN may have been incremented by 
more than one/ depending an the numher of sectors processed. 

25.3.1.14 lOCEDF — LSN of end-of-file 

The lOCEDF field overlays lOCSUF after the .OPEN 
function has been called (diskette I/O only). lOCEDF is a 
system-maintained parameter that represents the logical 
sector number of the logical end-of-file. This value must 
not be changed by the calling program once the .OPEN function 
has been invoked. 

25.3. 1. 15 lOCRIB — PSN of RIB 



This two-byte field of the IOCS is initialized with the 
physical sector number of the file's RIB after the .OPEN 
function has been called (diskette I/O only). The RIB is 
used to access the file via its SDWs to allocate additional 
space, to deallocate unused space, and to monitor the LSN of 
the file's logical end-of-file. The lOCRIB entry should 
never be changed by the calling program. 

25.3.1.16 lOCFDF — File descriptor flags 



This two-byte field contains the flags that describe the 
inherent and the changeable attributes of a file. The format 
of the IDCFDF entry is shown below: 
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8 



W 



N 



FMT 



< Not Used (=0) ■ 

File format bits 

Non— compressed space bit 

Contiguous allocation bit 

System file bit 

Delete protection bit 

Write protection bit 



"i s various wXwS ars usscriwcu vS^tOwi 

W (Bit F) — Write protection bit 

The "W" bit only applies to diskette files. If 
this bit is set to one* the file can only be accessed 
with input requests. Any I/O functions that attempt 
to write to a file with the "W" bit set uiill return 
an error. In addition* the file cannot be deleted. 
If the "W" bit is set to zeroi the file can fae read 
from) mritten to* or deleted (the "D" bit must be 
zero also). The "W" bit is one of the changeable 
attributes of a file. 

D (Bit E) — Delete protection bit 

The "D" bit only applies to diskette files. If 
this bit is set to one. the file cannot be deleted. 
If the "D" bit is set to zero* the file can be 
deleted (the "W" bit must be zero also). The "D" bit 
is one of the changeable attributes of a file. 

S (Bit D> — System file bit 

The "S" bit only applies to diskette files. If 
this bit is set to one* the file is considered to be 
a system file. System files are treated specially by 
the DIR* DEL, and DOSGEN commands. If the "S" bit is 
set to zero* the file is not a system file. The "S" 
fait is one of the changeable attributes of a file. 
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C (Bit C) — Contiguous allocation bit 

The "C" bit only applies to diskette files. If 
this bit is set to one. only contiguous diskette 
space can be allocated to the file. All files whose 
contents are to be loaded into memory directly from 
the diskette must be allocated contiguous space. 
the "C" bit is set to zero» the 
segmented diskette space. The 
inherent attributes of a file. 
the time the file is created 
thereafter. 



T * 



file may be allocated 
"C" bit is one of the 
It is specified at 
and cannot be changed 



N (Bit B) — Non-compressed space bit 

The "N" bit only applies to diskette files, 
this bit is set to onei ASCII records written to 
file will not have spaces compressed. If the "N" 
set to zero. ASCII records written to the 



IS 



mill have spaces 
following format: 



If 

the 

fait 

= ilg 



compressed into a byte of the 



Number of compressed spaces 
Compression flag (=1) 



All MDOS commands create ASCII files with space 
compression (N = 0) in order to minimize the amount 
of diskette space consumed. The "N" bit is one of 
the inherent attributes of a file. It is specified 
at the time the file is created and cannot be changed 
thereafter. The space compression attribute is only 
meaningful if the file format is ASCII record (FMT = 
5). For other formats. the space compression 
attribute is ignored. 

FMT (Bits a-A) — File format bits 



The 
structure 
inherent 
the time 



file format bits describe the internal data 

of the file. The file format is one of the 

attributes of a file. FMT is specified at 

the file is created and cannot be changed 



thereafter. The following table lists the values of 
FMT and their meanings: 
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FMT File format 



User-defined format. This format is only 
valid for diskette files. The record I/O 
functions cannot be used to access files with 
this format. Only logical sector I/O can be 
performed with this format. The calling 
program is responsible for extracting data 
from the sectors according to his data 
structure. 

1 Use device's default format for binary 
records. Each device has associated with its 
CDB (section 26.2) a flag that indicates what 
the default binary record format is (either 
pMj = 3 2r FFiT = 7>. Since some devices can 
only process seven— bit data while other 
devices can process both seven-bit and 
eight-bit data, this format (FMT = 1) allows 
a program to process binary records without 
knowing the specific format supported by a 
particular device. The program will always 
be dealing with eight-bit data in memory. 
The FMT field is automatically changed to 
either a "3" or "7" depending an the device 
by the . OPEN function. 

2 Memory-image format. This format applies 
only to diskette files. Any file whose 
contents are to be loaded into memory 
directly from the diskette must be in the 
memory-image format. Due to the nature of 
the diskette controller, memory-image format 
files must be allocated contiguous diskette 
space (C = 1 of lOCFDF). Memory-image files 
have no record information within the data 
sectors. All information concerning the 
starting load address, number of bytes to 
load, etc., is contained in the file's RIB. 
The load information must be written into the 
RIB by the program that is creating the 
memory-image file; the information is not 
automatically supplied by any system 
function. The load information must meet the 
requirements defined in section 24. 2. The 
record I/O functions cannot be used to access 
files with this format. Only logical sector 
I/O can be performed with this format. 
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3 Binary record format. This format applies to 
both diskette and non-diskette files; 
houeveri non-diskette files can only be 
accessed in the file format mode (F = of 
lOCDTT) using this format. 

A This format is undefined and should not be 
uses. 

5 ASCII record format. this format applies to 
both diskette and non-diskette files. 
Non-diskette files of this format can be 
accessed in either the file format or the 
non-file format modes. ASCII record files 
can be space compressed* but only if they 
reside on diskette. 

6 This format is undefined and should not be 
used. 

7 ASCII-converted-binary record format. This 
format usually applies to non-diskette files. 
This format is intended to be used for 
writing binary record files from the diskette 
to a non-diskette device that can only accept 
seven-bit data bytes. Otherwise) this format 
is identical to FMT =3. 

NOT USED (Bits 0-7) — Reserved arsa 

The least significant byte of the lOCFDF field 
is reserved for future expansion. This byte must be 
zero for all files. 

25.3. 1. 17 lOCDEN — Directory entry number 



Associated with each directory entry is a number/ the 
directory entry number, which is a function of the physical 
location of the entry within the directory. The directory 
entry number is not found anywhere in the directory. rather 
it is a calculated quantity. The two-byte lOCDEN field is 
supplied by the system after the .OPEN function (section 
5.3.3) has been called. It only applies to diskette files. 



25. J. 3) has been caiiea. iT oniy applies tu uiSRevi-tr riica. 
The contents of lOCDEN should never be changed by the calling 
program. The IDCDEN field has the following format: 



J 
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E D 

PSN 



A 9 
EN 



8 



< Not Used <=0) 

.... Position within sector <0-7> 
.... Physical sector number ('$3-*16> 
25. 3. 1. IS lOCSBP — Sector buffer pointer 



The lOCSBP 



tiijo-byte field o 
existing file is 
ignored. If a f 
the initial numb 
file. If the va 
the initial fi 
clusters) and no 
space allocation 
a non-zero (non— 
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The .ALLOC sys 
contains a mor 
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escriptor (32 
le 's initial 
vailable. If 
ed* houieveri 
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After a file has been opened, the lOCSBP contains a 
pointer into the sector buffer that is used by the record I/O 
functions. Therefore, the contents of lOCSBP must not be 
changed by the calling program once a file is open when using 
the record I/O functions. If the sector I/O functions are 
usedf then lOCSBP can be altered by the calling program in 
any way after a file is open. 

25. 3. 1. 19 lOCSBS — Sector buffer start 



This two-byte field of the IOCS only applies to diskette 
I/O. It must be initialized by the calling program before 
any of the I/O functions are invoked. lOCSBS roust be 
configured to contain the address of the first byte of a 
buffer into which one or more 128-byte sectors can be read. 
This sector buffer will be used for directory searches as 
well as for data transfers. lOCSBS will not be altered by 
any of the I/O functions. 

25.3.1.20 lOCSBE — Sector buffer end 



I/O. 



This two-byte field of the IOCS only applies to diskette 
It must be initialized by the calling program before 
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any of the I/O functions are invoked. lOCSBE must be 
configured to contain the address of the last byte of a 
sector buffer that is exactly large enough to accommcdste an 
integral number of 12S-byte sectors. An error mill occur if 
the size of the sector buffer described by lOCSBS and lOCSBE 
is not correct. Specif ically> the following relationship 
must be true: 

IOCSBE-IOCSBS+1 

= INTEGER (Maximum # of Sectors) 

128 
lOCSBE will not be altered by any of the I/O functions. 
25.3.1.21 lOCSBI — Internal buffer pointer 



This two-byte field of the lOCB applies only to diskette 
I/O. lOCSBI is used to indicate the end of valid data luithin 
sector buffers. Since partial buffers <an integral number of 
sectors less than or equal to the maximum sector buffer size) 
may be read or uiritten> lOCSBI is used to locate the last 
valid data byte within a sector buffer. 

lOCSBI is initialized and changed by the I/O functions. 
The contents of lOCSBI must not be changed by the calling 
program after a file has been opened when using the record 
I/O functions; however, when using logical sector 1/0/ the 
contents of lOCSBI may be changed. The value of lOCSBI mill 
always be less . than or equal to the value of IDCSBE. The 
folloiuing relationship must always be true: 

IOCSBI-IDCSBS+1 

-~— = INTEGER (Actual # of Sectors) 

128 
25.3.2 Reserve a device — . RESRV 



The . RESRV system function links the appropriate 
controller descriptor block (CDB) to the calling program's 
IOCS. The .RESRV function must be called before any other of 
the device independent I/O functions can be invoked. Section 
26.2.4 should be consulted for a description of the impact on 
the .RESRV call and the IOCS when using non-standard devices. 

ENTRY PARAMETERS: X = The address of an IDCB. 

lOCGDW must contain one of the valid 
generic device names: QH» CP. CRj 
DK, or LP. 

lOCLUN must contain the logical unit 
number of the device to be reserved. 



,.y 
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Bit "R" of lOCLUN must be set to zero 
(this will normally be the case when 
the ASCII logical unit number, 
*30-*39.. is stored into lOCLUN). 

All other entries of the lOCB need not be 
initialized. 



EXIT CONDITIONS: 



A is indeterminate. 

B = The contents of the IDCSTA entry. If 

no errors occurred, B ujill be zero. 

A non-zero value indicates that an 
error occurred. 



X is unchanged. 

C =0 and Z = 1 if no errors occurred <B 
= 0). The remainder of CC is 
indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 



The lOCB is affected in the following manner 
an error occurred: 



if 



lOCSTA contains the error status. The 
folloujin.g error statuses can be 
returned: I$IVDV. I$RESV, I$NODV. 

The remainder of the lOCB is not changed. 

The IDCB is affected in the following manner if 
no errors occurred: 

IDCSTA = 0. 

lOCDTT has the "10" bits set to zero and 
the "0" bit set to one (file closed). 
The remainder of the lOCDTT is not 
changed. 

lOCGDW contains the address of the CDB 
that is associated with the generic 
device. The original contents of 
lOCGDW 3TS destroyed. 

lOCLUN has the "R" bit set to one (lOCB 
reserved). The remainder of lOCLUN 
is not changed. 

The remainder of the lOCB is not changed. 
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The .OPEN function prepares a file for subsequent access 
by the record or logical sector I/O functions. Data cannot 
bs transferred between the file (or device) and the calling 
program until the OPEN function has been invoked. The 
specific function performed by .OPEN depends on the device 
type and on the contents of the IQCDTT entry (specifically, 
the non-file format flag (F) and the mode flag (M)). 

There are four modes in which a file can be opened. The 
input mode (M = 01 of lOCDTT) will allow only input requests 
to be issued to the file. The output mode (f1 = 10 of lOCDTT) 
will allow only output requests to be issued to the filej and 
the update modes (« = 00 or 11 of iOCSTTJ will allow both 
types of requests to be issued to the file. The update modes 
are only valid if the device type is DK. 

The non-file format flag also has an effect on what 
.OPEN does. If the file format mode is specified (F = of 
lOCDTT), then FDR processing will be performed. FDR 
processing consists of searching for a file descriptor record 
or a directory entry if the file is being opened for input. 
FDR processing consists of creating a file descriptor record 
or a directory entry if the file is being opened for output. 
One form of update mode processing <M = 11 of lOCDTT) will be 
identical to the input mode processing if the file already 
exists in the directory; ori it will be identical to the 
output mode processing if the file does not exist in the 
directory. The other form of update mode processing (M = 00 
of lOCDTT) will always be the same as the input mode 
processing since the file must exist for this mode. 

If a memory-image file is being created. the load 
information must be written into the RIB by the program that 
is creating the file and must meet the requirements described 
in section 24.2. The RIB can be accessed using logical 
sector I/O. It has the logical sector number SFFFF. 

If the non-file format mode is specified (F = 1 of 
lOCDTT), then no FDR processing is performed. The non-file 
format mode is invalid for diskette devices. 

ENTRY PARAMETERS: X = The address of an IOCS which has been 

properly reserved (i. e. . no errors 
occurred) via the . RESRV function. 
Since the IDCB needs to be reserved 
only once per device of a given 
logical unit numberi it is possible 
to open and close a file and then 
reopen another file using the same 
lOCB without issuing another . RESRV 
call. In these instances. the lOCB 



\ 
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must not contain information for an 
open file (i. e. . the first file must 
have been properly closed). The 
.OPEN function does not force an 
already— open file to be closed. 

laCDTT must have the "M" bits set for 
input* output* or update modes. The 
update modes are only valid for 
diskette devices. In addition. the 
"F" bit must specify file or non-file 
format. The non-file format mode is 
invalid for diskette devices. The 
"S" bit must indicate the subsequent 
access method to be used. Sector I/O 
is invalid for non-diskette devices. 

lOCDBS must contain a buffer start 
address unless diskette I/O (either 
record or logical sector) or the 
non-file format mode has been 
specified in the lOCDTT. The data 
buffer described by lOCDBS and lOCDBE 
is used for FDR processing with 
non-diskette devices. If used, it 
must be large enough to accommodate 
an FDR (section 24,3.4). 

lOCDBE must contain a buffer end address 
unless diskette I/O (either record or 
logical sector) or the non-file 
format mode has been specified in the 
lOCDTT. The data buffer described by 
lOCDBS and lOCDBE is used for FDR 
processing with non-diskette devices. 
If used, it must be large enough to 
accommodate an FDR (section 24.3.4). 

lOCNAM must contain a valid 
MDOS-formatted file name unless the 
non-file format mode has been 
specified in the IDCDTT or unless the 
first byte of file name is binary 
zero. It» the file format mode on a 
non-diskette device being opened for 
input, the .OPEN function will cause 
a search to be performed for the 
first FDR if the first byte of lOCNAM 
is a binary zero. This file will 
then be used by the subsequent record 
input requests. Othertuise, the file 
name supplied in lOCLUN, lOCNAM, and 
lOCSUF is searched for or created 
(depending on M of lOCDTT). 
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lOCSUF must contain a valid ^ 
MDOS-formatted suffix unless the 
non-fils format mode has been 
specified in the lOCDTT or unless the 
first byte of IDCNAM contained a 
binary zero (see above). 

lOCFDF must only be initialized to 
specify the file format (FMT bits) if 
the output mode <M = 10 of lOCDTT) or 
the update mode to a non-existing 
file (M = 11 of IDCDTT) is indicated. 
In addition, if the device type is 
DKi the other bits of lOCFDF must be 
specified for these two open modes. 
A special case exists if the non-file 
format mode is indicated in the 
lOCDTT. In this instance, the FMT 
bits of lOCFDF must be set to the 
ASCII record format (FMT = 5). 

It is not recommended that diskette 
files be created with the protection 
attributes set. since they will 
prevent a file from being deleted 
upon closing if no information u»as 
written into the file. The ./ 
protection attributes should be set 
via the . CHANG system function or via 
the NAME command. 

lOCSBP must be initialized if the device 
type is DK and either the output mode 
<M = 10 of lOCDTT) or the update mode 
to a non-existing file <M=il of 
lOCDTT) is specified. A value of 
zero uiill cause the default space to 
be initially allocated to the file. 
A non- zero value will cause that 
number of sectors to be used for the 
initial allocation. 

A non-zero value in lOCSBP when 
opening an existing file will have no 
affect on the allocation of the file. 
Existing files only change in size 
when writing beyond the end-of-file 
or when closing them with the 
truncate flag set. 

lOCSBS must contain the starting address 

of a sector buffer only if the ) 
device type is DK. The sector buffer -'' 
must be an integral number of sectors 
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in size <see section 25.3.1.20). 

lOCSBE must contain the address of the 
last byte of a sector buffer only if 
the device type is DK. The sector 
buffer must be an integral number of 
sectors in size (see section 
25. 3. 1.20). 

EXIT CONDITIONS: A is indeterminate. 

B = The contents of the lOCSTA entry. If 
no errors occurredi B will be zero. 
A non— zero value indicates that an 
error occurred. 

X is unchanged. 

C = and Z = 1 if no errors occurred <B 
= 0). The remainder of CC is 
indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The IOCS is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
following error statuses can be 
returned: I^CKSM, I*CLOS> I*DSPC, 
I*DTYP< I$DUPE. I$EOF, I$FSPC- 
I*FTYP, I«EOM, I«IVDV. I*NONMi 
I*NORV, I*NRDY, I*RIB. ISWRIT. 

The remainder of the lOCB and the 
contents of the data buffer 
(non-diskette device) and the sector 
buffer (diskette device) are 
indeterminate. 

The lOCB is affected in the following manner if 
no errors occurred: 

IQCSTA = 0. 

lOCDTT has the "O" bit set to zero (file 
open). The "T" bit will have been 
set to one if a new file had to be 
created on the diskette. The "10" 
bits are indeterminate. The 
remainder of lOCDTT is not changed. 
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lOCDBP is indeterminate. J 

lOCNAM is unchanged if the device type is 
not DK. If the device type is DK, 
then lOCNAM uiiil have been replaced 
with the four entries IQCMLS, lOCSDW. 
lOCSLS and lOCLSN. 

laCMLS contains the value «FFFF if the 
device type is DK. 

lOCSDW contains the first SDW from the 
file's RIB if the device type is DK. 

lOCSLS contains the value «FFFF if the 
device type is DK. 

IQCLSN contains the value zero if the 
device type is DK. 

IDCSUF is unchanged if the device type is 
not DK. If the device type is DKi 
then lOCSUF will have been replaced 
uiith the lOCEOF entry. 

lOCEOF contains the logical sector number 
of the logical end-of-file if the 
device type is DK. 

lOCRIB contains the physical sector 
number of the file's RIB if the 
device type is DK. 

lOCDEN contains the file's directory 
entry number if the device type is 
DK, 

lOCFDF contains the FDF field from the 
directory entry or the FDR (if open 
mode is input or update to existing 
file). Othertuise. the lOCFDF field 
contains its initial value; however, 
if the initial FMT bits contained a 
"1". FMT will have been changed to 
either a "3" or a "7" as described in 
section 25. 3. 1. lb. 

IQCSBP contains the value of zero if the 
device type is DK. 

lOCSBI contains the value in lOCSBE. 

The remainder of the IOCS is unchanged. -^ 



Page 25-38 



Tssjpyx/QUTPUT FUNCTIONS 25.3 — Device Independent I/O Functions 

The contents of the data buffer 

. (non-diskette device) and the sector 

buffer (diskette device) are 
indeterminate. 

25. 3. 4 Input a record — . OETRC 

The . GETRC function reads a record from an opened file 
or device into a data buffer. The specific processing 
performed by .GETRC depends on the FMT bits of lOCFDF and on 
the device type. The record input function will process 
three file formats: binary record (FMT = 3). ASCII record 
(PMf =5), and ASCII-converted-binary record (FMT = 7). 

Sinsr" records usill be stripped of their record header 
(see section 24. 3)> their byte count, and their checksums. 
Only the data characters between the byte count and checksum 
fields will be returned. If characters avs encountered after 
the checksum field of one binary record but before the header 
field of the next record, they will be ignored. 

ASCII records will be stripped of null characters, line 
feeds, rubouts, and the device control characters DC1-DC4. 
When reading records from the diskette, compressed spaces 
(bytes with bit 7 set to 1) will be- automatically expanded 
into the appropriate number of spaces before being placed 
into the data buffer. This automatic space expansion occurs 
regardless of the compression bit in IDCFDF (bit "N"). A 
carriage return will be the last data character in the data 
buffer. 

ASCII-converted-binary records are handled similarly to 
binary records; however, the conversion of two seven-bit data 
bytes into a single eight-bit data byte is automatically 
performed. 

The . GETRC function treats the system console (CN) in a 
slightly different way than it does other devices, since the 
input from this device is usually in an interactive mode with 
the operator. In addition to the normal ASCII record 
processing, .GETRC will perform the following. First, if the 
first byte of the lOCSUF field contains a displayable 
character in the range $20-$5F, it will be automatically 
displayed as an input prompt each time the .GETRC function is 
invoked Next, the special keyboard characters rubout ($7F), 
cancel (CTL-X, $1S), and EOT (CTL-D, $04) will cause the 
standard HDDS keyboard functions to be performed (section 
2.5). Rubout will delete the previously entered character, 
cancel will delete the entire input line entered thus far, 
and EOT will cause the input 'line entered thus far to be 
redisplayed on a new line of the console. Lastly. the 
carriage return character will cause a carriage return, line 
feed, and null sequence to ba sent to the console. All other 
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data characters will be echoed back to the console display 

mechanism as they ar'n entered from the keyboard. This 

function is the same as for the . KEYIN system function 

described earlier in this chapter (section 2S. 2. 1). 

ENTRY PARAMETERS: X = The address of an IOCS which has been 

properly reserved and opened (i. e. * 
no errors occurred) via the . RESRV 
and .OPEN functions, respectively. 

lOCDTT must have the "S" bit set to zero 
(record I/O). The mode flag (bit 
"M" ) must specify either the input or 
the update modes as configured prior 
to opening the file. 

lOCDBS must contain the address MihexB the 
first byte of the record is to be 
stored. 

lOCDBE must contain the address where the 
last byte of the maximum size record 
is to be stored. The buffer 
described by lOCDDS and IQCDBE must 
be large enough to accommodate the 
largest possible record that may be 
encountered in the file. 

lOCSUF may be configured by the calling 
program to contain a displayable 
character in its first byte if the 
input device is the system console. 
In this case, the character will be 
shouin on the console as an input 
prompt each time the . GETRC function 
is invoked. lOCSUF must not be 
changed after opening a file uihen 
other devices are used. 

lOCFDF must have been configured for a 
valid file format on a previous .OPEN 
call (FMT = 3. 5. or 7). 

EXIT CONDITIONS: A is indeterminate. 

B = The contents of the lOCSTA entry. If 
no errors occurred. B will be zero. 
« A non-zero value indicates that an 
error occurred. 



X is unchanged. 

C = and Z = 1 if no errors occurred (B 
= 0). The remainder of CC is 



\ 
^ 
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indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero>. The remainder of CC is 
indeterminate. 

The lOCB is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
follojuing error statuses can be 
returned: I*BUFO, ISCKSMi I*CLOS. 
I*DTYP, I*EOF, I*FTYP. I*EDM, I*NRDY, 
I*RANG, I*SECB. 

lOCDBP is indeterminate. 

lOCMLS, lOCSDW, lOCSLSi lOCLSN. lOCSBP/ 
and lOCSBI are indeterminate if the 
device type is DK. Otherwise* 
lOCNAM, lOCSBP, and lOCSBI are 
unchanged. 

The remainder of the IOCS is unchanged. . 

If a buffer overflow error occurred 
(lOCSTA = I4BUF0). then the last data 
character of the record (carriage 
return) will be the last character of 
the buffer. The first "n" characters 
(n being the size of the data buffer 
minus one) of the record are intact. 
Otheruiise» the contents of the data 
buffer are indeterminate. 

If the device type is DK. then the 
contents of the sector buffer are 
indeterminate. 

The lOCB is affected in the follotuing manner if 
no errors occurred: 

lOCSTA = 0. 

lOCDTT has the I/O transfer flag set to 
indicate input < 10 = 10). The 
remainder of lOCDTT is unchanged. 

lOCDBP contains the address of the last 
character read into the input buffer. 

lOCMLS. lOCSDW. lOCSLS, lOCLSNi lOCEOF, 
lOCSBP. and lOCSBI contain the 
system-maintained parameters as 
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described in section 25. 3. 1 i-P the 
device type is DK. They reflect the 
current diskette file pointers. 
lOCNAM. IDCSOF, lOCSBP. and lOCSBI 
are unchanged if the device is not 
DK. 

The remainder of the lOCB is unchanged. 

The data buffer contains the record. 

The sector buffer contains data from the 
logical sectors read. This number is 
given by lOCLSN minus the valid 
buffer size in sectors 
( ( lOCSBI-IQCSBS+i )/i2S) if the device 
is DK. 

25. 3. 5 Output a record — . PUTRC 

The .PUTRC function writes a record from a data buffer 
to an opened file or device. The specific processing 
performed by .PUTRC depends on the FMT bits of lOCFDF and on 
the device type. The record output function will process 
three file formats; binary record (FMT = 3)» ASCII record 
(FMT 3 5), and ASCII-c onverted-b inary record CFMT = 7). 

Binary records uiill be automatically supplied with their 
record header (see section 24.3), a byte count. and a 
checksum. In addition, a terminating carriage return is 
supplied by the .PUTRC function. If the output device is a 
non-diskette device, the terminating carriage return will 
actually be a carriage return, line feed, null seq.uence. 
None of these automatically supplied fields are present in 
the data buffer described by the IOCS. 

ASCII records will be automatically space compressed if 
the output device is diskette and if the "N" bit of lOCFDF is 
zero. Otherwise, spaces will not be compressed. A carriage 
return character will be automatically written to the output 
device after the last data character has been sent unless the 
last data character happens to be a carriage return. All 
carriage returns, those encountered within the data buffer as 
well as the automatically supplied terminating one, ars 
converted into a carriage return, line fee<i, null seq.uence 
when being written to a non-diskette device. The line feed 
and null characters generated from embedded carriage returns 
will not be written to the diskette. 

ASCII-converted-b inary records are handled similarly to 
binary records; however, the conversion of one eight-bit data 
byte into two seven-bit data bytes is automatically 
performed. 
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If a 
additional 
increased 
al location 
al location 



record is being written 
space ma-y be allocated 
space requirements of 
is done automatically. The 



into a diskette file, 
to accommodate the 
the file. The file 

amount of secondary 



u;i. 



11 depend on the available file spaces however, 
an attempt mill be made to allocate the default number of 
clusters. If less space is available than the default, then 
the largest available block uiill be allocated. 



ENTRY PARAMETERS: 



X = The address of an IOCS which has been 
properly reserved and opened (i. e. . 
no errors occurred) via the . RESRV 
and . OPEN functions, respectively. 

lOCDTT must have the "S" bit set to zero 
(record I/O), The mode flag (bit 
"M" ) must specify either the output 
or the update modes as configured 
prior to opening the file. 

lOCDBS must contain the address of the 
first byte of the record that is to 
be written. 

lOCDBE must contain the address of the 

last byte of the record that is to be 

written. A terminating carriage 

return is not req^uired in the data 
buffer. 

lOCFDF must have been configured for a 
valid file format during the previous 
.OPEN call (FMT = 3. 5. or 7). The 
non-compressed space bit (bit "N" ) 
determines whether or not spaces are 
compressed (only applies to ASCII 
files being written to diskette). 



EXIT CONDITIONS: 



A is indeterminate. 

B = The contents of the 
no errors occurred. 
A non-zero value 
error occurred. 



lOCSTA entry. If 
B will be zero, 
indicates that an 



X is unchanged. 

C = O and Z = 1 if no errors occurred (B 
=5 O). The remainder of CC is 
indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 
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The IOCS is affected in the folloiuing manner if 
an error occurred: 

lOCSTA contains the error status. The 
folloujing error statuses can be 
returned: I*CLOS, I*DTYP, I*FTYP, 
I$NRDY# I^RECL. I^RANG.- I«SECB. 
I*RIB, I$FSPC, I$SSPC. 

lOCDBP is indeterminate. 

lOCMLS, lOCSDW, lOCSLS, lOCLSN, IQCEOF, 
lOCSBP. and lOCSBI are indeterminate 
if the device type is DK. IOCNAMj 
lOCSUF; lOCSBP, and lOCSBI are 
unchanged othertuise. 

The remainder of the IOCS is unchanged. 

The contents of the data buffer are 
unchanged. 

The contents of the sector buffer avs 
indeterminate. 

The lOCB is affected in the following manner if 
no errors occurred: 

lOCSTA = 0. 

lOCDTT has the I/O transfer flag set to 
indicate output (10 = 01). If 
additional file space uias allocated, 
the truncate flag <T) is set to one 
if it was not already one prior to 
the output transfer. The remainder 
of lOCDTT is unchanged. 

lOCDBP contains the address of the last 
character in the data buffer (same as 
lOCDBE). 

lOCMLS. lOCSDW, lOCSLS, lOCLSN, lOCEOF, 
lOCSBP/ and IDCSBI contain the 
system-maintained parameters as 
described in section 25. 3. i if the 
device is DK. They reflect the 
current diskette file pointers. If 
. PUTRC has been called for the first 
time. and if lOCMLS contained the 
value $FFFF upon entry. IDCMLS will 
contain the value *0OO0 upon exiting J 
the function. In this way. the file 
will not be deleted upon closing. 

Page 25-44 



INPUT/OUTPUT FUNCTIONS 25. 3 — Device Independent I/O Functions 

even if only a single record has been 
written into the sector buffer. 

lOCNAM/ lOCSUF. lOCSBP. and lOCSBI 
are unchanged if the device is not 
DK. 

The remainder of the IOCS is unchanged. 

The contents of the data buffer are 
unchanged. 

The sector buffer contains the data that 
are going to be written to diskette 
starting uith the logical sector 
specified by lOCLSN. The sector 

been written. Thus, the parts of the 
sector buffer not affected by the 
. PUTRC call will still contain the 
data from the buffer last written. 

25.3.6 Close a file — .CLOSE 



The .CLOSE function is used to signify completion of all 
I/O .transfers to a file or device in the current open mode. 
Data cannot be. transferred between the file (or device) and 
the calling program after the .CLOSE function has been 
invoked. The specific function performed by .CLOSE depends 
on the mode flag (M of lOCDTT), the I/O transfer flag (10 of 
lOCDTT), and the device type. 

If the lOCB has been opened in the input mode (M = 01 of 
lOCDTT), then the .CLOSE function will simply change the lOCB 
to indicate that the file is closed. 

If the lOCB has been opened in the output mode (M - 10 
of lOCDTT), then .CLOSE will perform the following. For a 
device type of DK. .CLOSE will rero-fill any unused portions 
of the unwritten sector buffer to a sector boundary before 
writing the buffer to the diskette (only if record I/O is 
being performed; logical sector I/O will not cause the last 
sector buffer to be changed or written). All space that has 
been newly allocated but not written into (those logical 
sectors greater than lOCMLS) will normally be deallocated on 
a cluster boundary and returned to the free space pool 
(assumes that the truncate flag and lOCMLS have not been 
changed by the calling program). The end-of-file LSN will be 
adjusted in the RIB. If the device is not DKi then .CLOSE 
will cause an end-of-file record to be written to the device 
(file format mode only). In the non-file format mode* .CLOSE 
will only write an end-of-file record to the device if it is 
a file-type device (e.g.. an end-of-file is written to CP but 
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not to LP or CN>. File-type devices are those uihich use a 
medium that can fae re— read later. 

If the lOCB has been opened in the update modes (M = 00 
or H of lOCDTT), then .CLOSE will perform the same functions 
as in the input or the output mode depending on the last I/O 
transfer type. The . GETRC and . QETLS functions will set 10 
of lOCDTT to indicate an input transfer, while the . PUTRC and 
. PUTLS functions will set 10 of lOCDTT to indicate an output 
transfer. In the latter case, space is only deallocated if 
the truncate flag (T of lOCDTT) is set to one (done 
automatically when new space is allocated, or done by user to 
indicate file shortening or updating of end-of-file pointer 
in RIB). 

ENTRY FARAriETEHS; X = The address of an IOCS uihieh has oeeri 

properly reserved and opened (i.e., 
no errors occurred) via the . RESRV 
and . OPEN functions, respectively. 

Normally, no additional parameters 
ars required; however, when dealing 
with diskette files in the update 
mode (M = 00 or 11 of lOCDTT), the 
truncate flag (T of lOCDTT) and the 
maximum referenced logical sector 
number (lOCMLS) can be configured by 
the calling program. Since the 
update modes only set the truncate 
flag to one if a new file is created 
during the open process or if 
additisnal space is allocated during 
the output process (file grows), 
space will not be deallocated or the 
end-of-file pointer updated from 
existing files unless the truncate 
flag and lOCMLS are explicitly set up 
by the calling program. When lOCMLS 
is set to the value «FFFF (value set 
up during .OPEN), then the file will 
have its directory entry deleted in 
addition to having all of its space 
deallocated (if truncate flag is set 
to one when .CLOSE is invoked). 

lOCDBS and IQCDBE must describe a valid 
data buffer when dealing with 
non-diskette devices (output only) 
since an end-of-file record is 
written (file-type devices only). . 

EXIT CONDITIONS: A is indeterminate. 

B = The contents of the lOCSTA entry. If 



) 



I 
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no errors occurred* B will be zero. 
A non— zero value indicates that an 
error occurred. 

X is unchanged. 

C = and Z = 1 if no errors occurred (B 
= 0). The remainder of CC is 
indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The IOCS is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
following error statuses can be 
returned: I*CLOS, ISDELT, I*IDEN, 
I*RANG, I«SECB, I*FSPC, I*SSPC, 
I*RIB, I$DEAL. 

The remainder of the IOCS and the 
contents of the data buffer and the 
sector buffer are indeterminate. 

The IOCS is affected in the following manner if 
no errors occurred: 

lOCSTA = 0. 

lOCDTT has the "0" bit set to one (file 
closed). The remainder of the lOCDTT 
is unchanged. 

lOCRIB will be zero if the file was 
deleted from the diskette. Otherwise 
it will be unchanged. 

IDCEOF will contain the LSN of the 
logical end-of-file if the device 
type is DK. lOCEOF will be unchanged 
if the truncate flag was zero upon 
entry. 

The remainder of the lOCB is unchanged. 

The contents of the data buffer and the 
sector buffer are indeterminate. 
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25.3.7 Release a device — . RELES 



The .RELES function breaks the link between the 
appropriate controller descriptor block and the calling 
program's lOCB. The .RELES function should be the last I/O 
function called after all I/O has been completed. 



ENTRY PARAMETERS: 



X = The address of of an lOCB which has 
been properly reserved (i.e.* no 
errors occurred) via the . RESRV 
function. If the .OPEN function has 
been invoked at any time after 
reserving the IOCS/ the file < or 
device) must first be closed via the 
. CLOSE function before the lOCB can 
be released. 



EXIT CONDITIONS: 



A is indeterminate. 

B = The contents of the lOCSTA entry. If 
no errors occurred/ B mill be zero. 
A non— zero value indicates that an 
error occurred. 



X is unchanged. 

C = and Z = 1 if no errors occurred 
= 0). The remainder of CC 
indeterminate. 



(B 

is 



C = 1 and Z = O if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 



The IOCS is affected in the following manner if 
an error occurred; 

IDCSTA contains the error status. The 
following error statuses can be 
returned: ISNORV, I*CLOS. 

The remainder of the lOCB and the 
contents of the data buffer and the 
sector buffer are unchanged. 

The IOCS is affected in the following manner if 
no errors occurred: 

lOCSTA = 0. 

lOCGDW = 0. 

lOCLUN has the "R" bit set to zero CIOCB 



.y 
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released). The remainder of IDCLUN 
is unchanged. 

The remainder sf the lOCB and the 
contents of the data buffer and the 
sector buffer sre unchanged. 



25. 3. S Example of device independent I/O 



The following example uses the 
functions described thus far. Th 
in the example as the control block 
file. The initial values set up in 
most output operations. A fouT— se 
allovu a maximum of four sectors to 
each time it is accessed. inS *arg 
fewer will be the number of diske 
unit number, file name, and su 
initialized from an operatoi — su 
command line. The system symbols f 
are used throughout this example. 



device inde 
e IOCS shown b 
for writing t 
this IOCS ars 
ctor buffer 
be written to 
er a sector bu 
tte accesses, 
ffix are goi 
pplied parame 
rom the MDOS 



pendent 
slow is 
o a disk 

typical 
is used 
the disk 
ffer is. 

The log 
ng to 
ter on 
equate 



I/O 
used 
ette 

for 

to 

ette 

the 

ical 

be 

the 
file 



OUTPUT 


EQU 


» START OF OUTPUT iU^-B 




FCB 


. IOCS! A 




FCB 


DT*OPO+DT*CLS . lOCDIl 




FDB 


. lOCDBP 




FDB 


RBUFF . lOCDBS 




FDB 


RBUFFE . lOCDBE 




FCC 


2. DK . lOCGDW 




FCB 


'0+0 . lOCLUN — DEFAULT = 




FCC 


5. . lOCNAM 




FCC 


2, SA . lOCSUF — DEFAULT = SA 




FDB 


. lOCRIB 




FDB 


FD*FMA!<S . lOCFDF — ASCII 




FDB 


. RESERVED 




FDB 


. lOCDEN 




FDB 


. lOCSBP 




FDB 


SCTBUF lOCSBS 




FDB 


SCTBUF+<SC*SIZ*4)-1 . lOCSBE 




FDB 


. lOCSBI 


SCTBUF 


BSZ 


SC$SIZ»4 . SECTOR BUFFER (4 SECTORS) 


RBUFF 


BSZ 


80 . RECORD BUFFER 


RBUFFE 


EQU 


*-l 



The code that is shown below performs the following 
functions. First, a file name specification which has been 
entered on the MDOS command line is extracted from the 
command line buffer and placed into the IOCS. This is 
accomplished with the . PFNAM sy.stem function described in 
Chapter 27. Then, the lOCB is reserved and opened. Next, an 
input prompt is displayed on the system console and an line 
of text is accepted from the keyboard. If the entered line 



Page 25-49 



INPUT /OUTPUT FUNCTIONS 



25.3 



Device Independent I/O Functions 



consisted of only a 
released* and control 
interpreter (via the 
entered line is written 



carriage return, the IOCS is closedi 
returned to the MDOS command 
function .MDENT). Otherujise* the 

into the diskette file. The input 



■~N 



process is repeated until only a carriage return is entered. 

The error message functioni . MDERR/ is used to display 
standard error messages if an invalid file name specification 
is enteredi if a file name is missing* or if one of the I/O 
functions returns an error condition (e. g. * if the file name 
already exists in the directory* or if insufficient diskette 
space is available). The function . ADBX is used to add the 
contents of the B accumulator to the index register. Both of 
these functions are discussed in detail in Chapter 27. 

In this example, the assumption is made that the program 
is invoked from the MDOS command line. Thus* it must be 
origined to load above location «1FFF. The stack pointer is 
automatically initialized through the loading process to 
point to the last-loaded program location. The stack area 
has been set up so that the default value of the stack 
pointer can be used tuithout having to execute a load stack 
pointer instruction. 



PROCESS FILE NAME PACKET 
INPUT PROMPT 



THE FILE NAME FROM THE COMMAND LINE 



4tOUTPUT+I0CLUN 



* DEFINE SOME WORKING STORAGE 
» 

PFNPAK FDB 0, 
PROMPT FCB ' : * EOT 
* 

* EXTRACT 
* 
START LDX 

STX 

LDX 

STX 

LDX 

SCALL 

TSTB 

BEQ 

A5LB 

BCS 

LDAB 

BRA 
» 

ERRl LDAB 
ERR2 SCALL 

BRA 
* 
ERRS CLRB . 

BRA ERR2 
* 
» OPEN AND RESERVE THE 



PFNPAK+2 
CBUFPS 
PFNPAK 
#PFNPAK 
. PFNAM 

STARTA 

ERRl 

#7 

ERR2 

#5 

. MDERR 

MDOS 



DESTINATION OF FILE NAME 
POINTER INTO CMD BUFFER 
SOURCE OF FILE NAME 

FORMAT STANDARD FILE NAME 
CHECK FOR ERRORS 
E<3 => GOOD NAME 

CS => NAME MISSING 
ILLEGAL NAME MSG NUMBER 



NAME REQUIRED MSG NUMBER 
DISPLAY STD ERROR MSG 
EXIT THE PROGRAM 



I/O ERR MSG NUMBER i 
FROM lOCSTA 



DECODED 



lOCB — CREATE THE OUTPUT FILE 
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STARTA LDX #OUTPUT 

SCALL . RESRV 

BCS ERR3 

SCALL . OPEN 

BCS ERR3 

* GET LINE FROM CONSOLE 

* 

LOOP LDX 

SCALL 

LDX 

LDAB 

SCALL 

LDAA 

CMPA 

BEQ 

STX 

DEX 

SCALL 

STX 

LDX 



CS => ERROR 



CS => ERROR 



DISPLAY THE INPUT PRONPT, NO CR/LF 



GET THE INPUT LINE 



ftPROMPT 

. DSPLZ 

#RBUFF 

#RBUFFE-RBUFF 

. KEY IN 

X . GET 1ST CHAR IN BUFFER 

#CR . CHECK FOR TERMINATOR 

EXIT . EQ => THIS IS THE TERMINATING LINE 

OUTPUT+IOCDBS . SETUP START RECORD POINTER 

. CALC END OF RECORD BUFFER 
. ADBX . B = NUMB CHARS INPUT 
OUTPUT-*- 1 OCDBE . SETUP END RECORD POINTER 
#OUTPUT 



SCALL . PUTRC 
BCC LOOP 



WRITE THE RECORD 
CC => NO ERRORS 



BRA 



ERR3 



» CLOSE AND RELEASE THE lOCB, RETURN TO MDOS 



EXIT 



POINT TO THE lOCB 



LDX #OUTPUT 

SCALL . CLOSE 

BCS ERR3 

SCALL . RELES 

BCS ERR3 

MDOS SCALL . MDENT 
* 

* LEAVE SOME ROOM FOR STACK 

BSZ eO . STACK SET HERE BY LOAD 

END START 



CS => ERROR 

CS => ERROR 
RETURN TO MDOS 



25.3.9 Specialized diskette I/O functions 



Three additional I/O functions exist that also use the 
lOCB as a parameter table; however, they are dependent on the 
device type being DK. An error will be returned if any other 
device type is specified. 

25.3.9.1 Input logical sectors — . GETLS 



The .GETLS function reads one or more logical sectors 
from an opened file into a sector buffer. 



ENTRY PARAMETERS: 



X = The address of an IOCS which has been 
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properly reserved and opened (i.e.* 
no errors occurred) via the . RESRV 
and . OPEN functionsi respectively. 



lOCDTT must have the "S" bit set to one 
(sector I/O). The mode flag (bit 
"H") must specify either the input or 
the update modes as configured prior 
to opening the file. 



lOCLSN must contain , the logical sector 
number that is to be read. The 
number of sectors read depends 
size of the sector buffer (see 
The data sectors of the file 
with logical sector zero. If 
is to be accessed via the 



actual 
on the 
beloiii). 
beg in 
the RIB 



. SETLS function! then 
contain the value $FFFF. 



lOCLSN must 



lOCSBS must CO 
of a se 
buffer mus 
sectors 
25. 3. 1. 20) 
necessar il 
used to op 
buffer can 
for each . 
sector bu 
file has b 
IDCSBEi an 
the callin 



ntain the 
ctor buff 
t be an in 

in size 
This 
y have t 
en the fi 

be in a d 
SETLS call 
ffer is to 
een opene 
d lOCSBI m 
g program 



starting address 
er. The sector 
tegral number of 
(see section 
buffer does not 
o be the same one 
le. The sector 
ifferent location 
j hou/everi if the 
be moved after a 
d, then lOCSBS, 
ust be changed fay 



lOCSBE must contain the address of the 
last byte of a sector buffer. The 
sector buffer must be an integral 
number of sectors in size (see 
section 25.3.1.20). The buffer 
described by IDCSBS and lOCSBE 
indicates the maximum number of 
sectors that can be processed 
starting with the logical sector 

in lOCLSN. 



whose number is 



EXIT CONDITIONS: 



A is indeterminate. 

B = The contents of the lOCSTA entry. If 

no errors occurred. B will be zero. 

A non-zero value indicates that an 
error occurred. 



X is unchanged. 
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C = and Z = 1 if no errors occurred (B 
= 0). The remainder of CC is 
indeterminate. 

C = 1 and Z = O if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The IOCS is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
fallowing error statuses can be 
returned: I«CLOS, I*DTYP, I*EOF, 
I*SECB» I*RANe. 

IDCHLS.- lOCSDW.- lOCSLS, lOCLSN.. TDCSBP. 
and lOCSBI are indeterminate. 

The remainder of the IOCS is unchanged. 

The contents of the sector buffer are 
indeterminate. 

The IOCS is affected in the following manner if 
no errors occurred: 

lOCSTA = 0. 

IOCMLS# lOCSDW, and lOCSLS contain the 
system— maintained parameters as 
described in section 25. 3. 1. They 
reflect the current diskette file 
pointers. 

lOCLSN has been incremented by the number 
of sectors read into the buffer 
( ( IDCSBI-IOCSBS+1 ) /128) . 

lOCSBP contains the starting address of 
the sector buffer (the same as 
lOCSBS). 

lOCSBI contains the address of the last 
valid data byte in the sector buffer. 
If only a partial segment utas read 
into the buffer, IDCSBI will not be 
the same as lOCSBE (maximum end of 
buffer). The following relationship 
should be used to calculate the 
number of sectors read: 

IOCSBI-IOCSBS+1 

= # SECTORS READ 
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12S 

The remainder of the IOCS is unchanged. 

The sector buffer contains the data from 
the sectors read beginning ujith the 
logical sector uhose number u<as in 
lOCLSN. 

25.3.9.2 Output logical sectors — . PUTLS 

The .PUTLS function writes one or more logical sectors 
from a sector Buffer to an opened file. Additional space (nay 
be allocated to the file to accommodate the increased space 
T>gn M 1 -pgingri* s_ The S"ac9 allocatloH is oerformed 
automatically. The amount of secondary allocation will 
depend on the available spacei however^ an attempt will be 
made to allocate the default number of clusters. If less 
space is available than the defaults then the largest 
available block will be allocated. 

ENTRY PARAMETERS: X = The address of an lOCB which has been 

properly reserved and opened ( i. e. . 
no errors occurred) via the . RESRV . 
and .OPEN functions* respectively. 

laCDTT must have the "S" bit set to one 
(sector I/O). The mode flag (bit 
"M" ) must specify either the output 
or the update modes as configured 
prior to opening the file. 

lOCLSN must contain the logical sector 
number that is to be written into. 
The actual number of sectors written 
depends on the size of the sector 
buffer (see below). The data sectors 
of the file begin with logical sector 
zero. If the RIB is to be accessed 
via the . PUTLS function, then lOCLSN 
must contain the value $FFFF. 

lOCSBS must contain the starting address 
of a sector buffer containing the 
data to be written. The sector 
buffer must be an integral number of 
sectors in size (see section 
25.3.1.20). This buffer does not 
necessarily have to be the same one 
used to open the file. The sector 
buffer can be in a different location 
for each .PUTLS calli however, if the 
sector buffer is to be moved after a 
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file has been opened* then lOCSBS; 
IDCSBE/ and lOCSBI must be changed by 
the calling program. 

lOCSBE is not used during the . PUTLS 
functioni howeveri it should not have 
been changed since the file uas 
opened (with restrictions mentioned 
above for lOCSBS). 

lOCSBI must contain the address of the 
last data byte to be written from the 
sector buffer. The sector buffer* as 
described by lOCSBS and lOCSBI* roust 
be an integral number of sectors in 
size (see section 25.3.1.20). 

EXIT CONDITIONS: A is indeterminate. 

B s The contents of the lOCSTA entry. If 
no errors occurred* B will be zero. 
A non-zero value indicates that an 
error occurred. 

X is unchanged. 

C = and 1=1 if no errors occurred (B 
= 0). The remainder of CC is 
indeterminate. 

C = 1 and Z = if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The lOCB is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
following error statuses can be 
returned: I«CLOS, I«DYTP, I«SECB* 
I«RANG. I*RIB* i»FSPC* ISSSPC. 

lOCMLS* lOCSDW* lOCSLS* lOCLSN* lOCEOF, 
lOCSBP. and lOCSBI are indeterminate. 

The remainder of the IOCS and the 
contents of the sector buffer are 
unchanged. 

The lOCB is affected in the following manner if 
no errors occurred: 

lOCSTA = 0. 
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lOCMLS^ lOCSDWi and lOCSLS contain the 
system-maintained parameters as 
described in section 25. 3. 1. They 
reflect the currant diskette file 
painters. 

lOCLSN has been incrsmentsd by the number 
of sectors written 

<(I0CS3I-I0CS3S+1)/128). If- the 
sector specified by the entry value 
of lOCLSN or any of the sectors 
written from the buffer was outside 
of the range of the file's allocated 
spacBi additional file space will 
have been allocated (if available). 

lOCEOF contains the logical sector number 
of the logical end-of-file. If 
additional file space was allocated^ 
lOCEOF will contain the new 
end-of-file LSN. lOCEOF is unchanged 
otherwise. 

IQCSBP contains the starting address of 
the sector buffer (the same as 
IDCSBS). 

The remainder of IOCS and the contents of 
the sector buffer are unchanged. 

25.3.9.3 Rewind file — . REWND 



The .REWND function resets the pointers of the IOCS so 
that subsequent I/O functions will access the diskette file 
as if It had just been opened, i. e. . from the beginning. 
Only files that have been opened in the update or input mode 
can be rewound. Files opened in the output mode will cause 
the . REWND function to return an error condition. 

ENTRY PARAMETERS: X = The address of an IOCS which has been 

properly reserved and opened (i. e. > 
no errors occurred) via the . RESRV 
and . OPEN functions, respectively. 

lOCDTT can have the "S" bit set to 
indicate either record or sector I/O. 
The mode flag (bit "M" ) must specify 
either input or update modes as 
configured prior to opening the file. 

lOCSBS must contain the starting address 
of a sector buffer. The sector 
buffer must be an integral number of 
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sectors in size (see section 

25.3.1.20). This buffer does not 

necessarily have to be the same one 

used to open the file; houjever* if 

the sector buffer is to be moved 

after a file has been opened, then 

lOCSBS* lOCSBE/ and lOCSBI must be 
changed by the calling program. 

lOCSBE must contain the address of the 
last byte of a sector buffer. The 
sector buffer must be an integral 
number of sectors in size <see 
section 25. 3. 1. 20). 



EXIT CONDITIONS: 



A is indeterminate. 

B = The contents of the lOCSTA entry. If 
no errors occurred./ B will be zero. 
A non— zero value indicates that an 
error occurred. 



X is unchanged. 

C = and Z = 1 if' no errors occurred 
= 0). The remainder of CC 

indeterminate. 



(B 
is 



C = 1 and Z - if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The lOCB is affected in the following manner if 
an error occurred: 

lOCSTA contains the error status. The 
same error statuses can be returned 
as those that can be returned by the 
. OPEN and . CLOSE functions. 

lOCMLB. lOCSDW, lOCSLS, lOCLSN, lOCEOFi 
lOCSBP/ and lOCSBI avs indeterminate. 

The remainder of the lOCB is unchanged. 

The contents of the sector buffer are 
indeterminate. 

The lOCB is affected in the following manner if 
no errors occurred: 



lOCSTA = 0. 

lOCDTT has the "T" bit set to zero. 



If 
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the fait was set to one before the 
. REWND call uas issued# space may 
have been deallocated from the file 
and the end-of-file pointer in the 
RIB updated. The remainder of lOCDTT 
is unchanged. 

lOCMLS contains the value $FFFF. 

lOCSDW contains the first SDW from the 
file's RIB. 

lOCSLS contains the value $FFFF. 

lOCLSN contains the value zero. 

lOCEOF contains the LSN of the logical 
end-of-file from the file's RIB. 

lOCSBP contains the value zero. 

lOCSBI contains the value in IDCSBE. 

The remainder of the lOCB is unchanged. 



The contents of 
indeterminate. 



the sector buffer ars 



The effect of veui 
same as if 
function were 
. REWND func 
without havin 
re-specify 
suffix. Thu 
rewound/ the 
and en 
consideration 
file were clo 
flag is set 
call (opening 
calling progr 
flag if space 
the end-of-f 
calling the 
function. 



inding a file is the 

a . CLOSE and a . OPEN 

performed; however* the 

tion reopens the file 

g the calling program 

the file's name and 

Sj when the file is 

same space deallocation 

d-of-file pointer 

s take effect as if the 

sed. Since the truncate 

to zero after the .REWND 

an existing file)/ the 

am may have to reset the 

is to be deallocated or 

ile pointer updated upon 

subsequent . CLOSE 



25.3.9.4 Example of logical sector I/O 



The following example uses the logical sector I/O 

functions. The IOCS shown below is used in the example as 

the "control block for reading from and writing to a diskette 

file. The initial values set up in this IOCS are similar to 
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those in the example given in section 25.3.8; however, the 
sector I/O and update (nodes are specified in the lOCDTT 
entry. Only a single sector is used for a sector buffer to 
make the management of logical sectors easier (eliminates 
calculation of the number of sectors read or written). The 
logical unit number, file name* and suffix are going to be 
initialized by an operator-supplied parameter obtained from 
the cosMsand line. The system sysnbais from the HDDS eq.uate 
file are used throughout this example. 



TEXFIL 


EQU 


» 




START OF TEXFIL lOCB 




FCB 







IOC ST A 




FCB 


DT«OPU+DT«SIO+DT*CLS . lOCDTT 




FDB 







lOCDBP 




FDB 







lOCDBS 




FDB 







lOCDBE 




FCC 


2. DK 




I0C6DW 




FCB 


'0+0 




lOCLUN — DEFAULT = 




FCC 


S. 




. lOCNAM 




FCC 


2. SA 




lOCSUF — DEFAULT = SA 




f-UB 







lOCRIB 




FDB 


FD*FMA ! 


<8 


lOCFDF — ASCII 




FDB 







RESERVED 




FDB 







lOCDEN 




FDB 







lOCSBP 




FDB 


SECBUF 




lOCSBS 




FDB 


SECBUF+SC?SIZ-1 . lOCSBE 




FDB 





■ 


lOCSBI 


* 

SECBUF 


BSZ 


SC*SI2 




SECTOR BUFFER 



The code that is shoun below performs the following 
functions. First, a file name specification which must have 
been entered on the MDOS command line is extracted from the 
command line buffer and placed into the IOCS. This is 
accomplished with the . PFNAM system function described in 
Chapter 27. Then, the lOCB is reserved and opened. Next, 
one sector is read from the file and all upper case 
alphabetic characters are converted into lower case 
characters. A special check is made for punctuation marks 
(period, exclamation point, and ciuestion mark) so that the 
first alphabetic character following such punctuation is left 
upper case. After all bytes within the sector have been 
processed, they are rewritten into the same sector from which 
they were read. The process is repeated until an end— of— file 
condition is encountered. Finally, after the file is closed 
and released. control is returned to the MDOS command 
interpreter via the function . MDENT. Since the file does not 
expand, it was opened in the update mode so that sectors 
could be both read from and written to the file. It should 
be noted that the logical sector number should be decremented 
before a sector is written back from where it was read. 

The error message function. . (iDERR* is used to display 
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standard error messages if an invalid file name specification 
is entered* if a file name is missing* of if one of the I/O 
functions returns an error condition. The system function 
.ALPHA is used to test for alphabetic characters. Both of 
these functions are discussed in detail in Chapter 27. 



In this e:iample> the assumption is made that the program 
is invoked from the MDOS command line. Thus* it must be 
origined to load above location *1FFF. The stack pointer is 



automatical ly 



:sd through the loading process to 



point to the last-loaded program location. The 
has been set up so that the default value 
pointer can be used without having to execute a 
pointer instruction. 



stack arsa 

of the stack 

load stack 



* DEFINE SOME WORKING STORAGE 
* 

PFNPAK FDB 0. . PROCESS FILE NAME PACKET 
UCFLG FCB . UPPER CASE CONVERSION FLAG 
* 

* EXTRACT NAME FROM COMMAND LINE 

:LUN . DESTINATION OF NAME 

SOURCE OF NAME 



EXTRACT FILE NAME 
CHECK FOR VALID NAME 
EQ => GOOD 



START 


LDX 


#TEXFIL+IC 




STX 


PFNPAK+2 . 




LDX 


CBUFP* 




STX 


PFNPAK 




LDX 


#PFNPAK 




SCALL 


. PFNAM 




TSTB 






BEQ 


STARTA 




ASLB 






DCS 


ERRl 




LDAB 


#7 


* 

ERRl 


BRA 


ERR2 


LDAB 


#5 


ERR2 


SCALL 


. MDERR 


ERRS 


BRA 


EXIT 


CLRB 






BRA 


ERR2 



CS => NAME MISSING 
ILLEGAL NAME MSG NUMBER 



NAME REQUIRED MSG NUMBER 
DISPLAY ERROR, THEN EXIT PROGRAM 
I/O FUNCTION ERROR MSG NUMBER 



* RESERVE AND OPEN THE lOCB 
* 
STARTA LDX #TEXFIL 

SCALL . RESRV 

BCS ERR3 

SCALL . OPEN 

BCS ERR3 

* nc.«iy A L.uGi,v.Ai_ ocw i un iNiu owrreK 



CS => ERROR 
CS => ERROR 
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CS => ERROR, POSSIBLE END OF FILE 



LOOPl LDX #TEXFIL 

SCALL . GETLS 

BCS EOF 

* 

» CONVERT DATA WITHIN SECTOR BUFFER 
* 

TEXFIL+IOCSBP . 

X . SET CKAR FROM BUFFER 

CONVRT 

X . PUT CHARACTER BACK 

. INCREMENT BUFFER POINTER 

TEXFIL+IOCSBP . SAVE POINTER 

TEXFIL+IOCSBE . CHECK FOR LAST CHARACTER 

L0OP2 . NE => MORE DATA TO CONVERT 

X . CONVERT LAST CHARACTER 

CONVRT 

X 



LOOP 2 LDX 
LDAA 
BSR 
STAA 
INX 
STX 
CPX 
BNE 
LDAA 
BSR 
STAA 



* WRITE LOGICAL SECTOR BACK INTO FILE 

TEXFIL+IOCLSN . PICK UP LSN 

. POINT BACK TO LAST READ SECTOR 
TEXFIL+IOCLSN . 
#TEXFIL 

. WRITE THE SECTOR BACK 

. CS => ERROR 
LOOPl . READ NEXT. SECTOR AND CONTINUE 



LDX 

DEX 

STX 

LDX 

SCALL . PUTLS 

BCS ERR3 

BRA 



EOF 



* END-OF-FILE DETECTED ON INPUT 
* 

#I*EOF 
ERR3 
#TEXFIL 
. CLOSE 
ERRS 
. RELES 
ERR3 
. MDENT 



NE => I/O ERROR 



CS => ERROR 



CMPB 

BNE 

LDX 

SCALL 

BCS 

SCALL 

BCS 
EXIT SCALL 
* 

* CONVERT ALL UPPER CASE ALPHABETIC CHARACTERS TO LOWER 

* CASE CHARACTERS. FIRST ALPHABETIC 

» CHARACTER FOLLOWING A PERIOD. EXCLAMATION POINT, OR 

* QUESTION MARK IS NOT CHANGED. 
♦ 

CHECK FOR U/C ALPHABETIC 



CS => ERROR 

RETURN TO MDOS COMMAND INTERPRETER 



CONVRT SCALL 
BCS 
TST 
BNE 
OR A A 

CONVEX CLR 

C0NEX2 RTS 

* 

CONTRM CMPA 
BEQ 



. ALPHA 

CONTRM 

UCFLG 

CONVEX 

#SPACE 

UCFLG 



SETFLG 



NE => DON'T CONVERT 

CONVERT TO L/C 

RESET FLAG TO CONVERT NEXT ALFA 



PERIOD 



Page 25-61 



INPUT/OUTPUT FUNCTIONS 



25. 3 -=- Device Independent I/O Functions 



#'5 

SETFLG 

#'? 

C0NEX2 

UCFLG 

CONEX2 



CMP A #'! - EXCLAMATION 

BEQ 

CMPA #'? . QUESTION 

BNE 
SETFLG INC 

BRA 
» 
* SAVE SOME ROOM FOR STACK 

BS2 SO . STACK POINTER SET HERE BY LOAD 
* 

END START 



25. 3, 10 Error handling 



All of the I/O functions discussed in this section use 
the IOCS. The first entry of the lOCB will contain an error 
status upon returning from one of these functions. The 
calling program is responsible for processing these error 
conditions. If the error status is to be decoded and 
displayed as a message on the system console. the system 
error message function, . MDERR* can be used. This function 
is described in detail in Chapter 27; however/ it should be 
noted here that a common mistake is made in calling the error 
message function with the value returned in the B accumulator 
by the I/O functions. It is true that this value is the same 
as IQCSTA's contents; however this is not the parameter that 
should be used to invoke the error message function. The 
error message function will decode the contents of IDCSTA 
only if it is called with the B accumulator equal to zero and 
with the X register pointing to the lOCB. 

None of the I/O functions described here will return 
control to the calling program if a diskette controller error 
is detected (only applicable if the device type is DK), 
These errors are fatal errors and will cause the program to 
be aborted (i.e., the files will not be closed). An error 
message is displayed on the system console before giving 
control to MDOS. 



In order to 
(especially on 
enough that it is 
for an error c 
common mistake is 
has been closed 
the closing^ data 
being apparent. 
IOCS with the "0" 
in the wrong s 
lOCB is reserved, 
functions themsel 



guarantee the integrity of data files 

the diskette). it cannot be stressed often 
necessary for the calling program to check 

ondition after each I/O function call. A 
to fail to check ^ov errors after a file 
Since output can still take place during 
at the end of the file can be lost without 
Another common mistake is to initialize the 
flag of lOCDTT and the "R" flag of lOCLUN 

ense. If the "R" flag is cleared before the 
the "O" flag will be properly set by the 

ves. 



Page 25-62 



CHAPTER 26 



26. INPUT/OUTPUT PROVISIONS FOR NON-SUPPORTED DEVICES 



It is assumed that the reader is familiar with the 
device independent I/O functions described in section 25.3 
before this chapter is Tead. 

This chapter describes how the I/O functions interface 
ujith the hardware device and how a user can interface 
non-standard devices for use with the device independent I/O 
functions. 

26. 1 Device Dependent I/O 



The device dependent I/O functions described in Chapter 
25 for accessing the console and the line printer cannot be 
changed to access non-standard devices. These routines are a 
part of MDOS and its basic environment req^uirements; however^ 
"3 user can construct his own device drivers that are accessed 
by his programs. If the standard MDOS commands are to 
utilize non-standard devices- the user should be using MODOS 
(OEM MDOS) which can be configured to work in that manner. 
The COPY command (Chapter 7) is an exception. It can load a 
user— defined device driver into memory to copy a file from 
that device to the diskette or from the diskette to that 
device. 

26.2 Device Independent I/O 



This section describes houi the device independent I/O 
functions interface to the device drivers which, in turn, 
interface directly to the hardware device. This description 
applies to both standard and non-standard devices. 

26.2. 1 Controller Descriptor Block — CDB 



The Controller Descriptor Block, or CDB, is a table that 
describes a physical device and the types of input and output 
operations that can be performed by the device. Unlike the 
IOCS, the CDB is configured only once for each device. It is 
the memory location of the CDB that replaces the contents of 
the lOCGDW entry of an lOCB after the . RESRV function has 
been called. The format of the CDB is shown in the following 
d iagram. 
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Byte 



< — Bit position 



V 
00 


S 




IOCS address 


1 
1 


CDBIOC 




Oi 


i 






i 


CDBSDA 




02 


! 




•Device driver 
address 






03 










CDBHAD 




04 






Hardware address 






05 










CDBDDF - 




06 


1 R 





1 I 1 F i W ! S ! L 


D 1 


Device descrip 
tor flags 
Valid data 
types 


07 


i N 




i 3 i 




CDBVDT - 


08 






Device dependent 
area 




CDBDDA 


09 










CDBWST 




OA 






Working storage 


, , 




OB 








! 
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GDB FLAG DESCRIPTION SUMMARY 



Field Name Bit 



Content 



CDBDDF R 7 



6 



I 5 



F 4 



W 3 



S 2 



L i 



D 



Reservable device flag 

=> Not reservable 

1 => Reservable 
Output device flag 

=> Cannot perform output 

1 => Can perform output 
Input device flag 

=> Cannot perform input 

1 => Can perform input 
File-type device flag 

=> Cannot epen/elose files 

1 => Can open/close files 
Reuindable device flag 

=> Cannot rewind files 

1 => Can rewind files 
System console flag 

=> Not system console device 

1 => System console device 
Logical sector I/O flag 

=> Cannot perform logical sector 

I/O . 

1 => Can perform logical sector I/O 
Default binary record format flag 

=> Binary record is default binary 

format 

1 => ASCII-converted-binary record is 

default binary format 



CDBVDT N 7 



3-6 
B 2 



0-1 



Non-file format flag 

=> Non— file format mode is invalid 

1 => Non— file format mode is valid 
Not used (=0) 

Binary I/O flag 

=> Eight— bit data is invalid 

1 => Eight-bit data is valid 
Not used (=0) 
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26. 2. 1. 1 CDBIOC — Current IOCS address 

These t?uo-bytss of the CDB are reserved for expansion. 
They are currently not being used by the device drivers. 
These tujo bytes should be initialized to zero. 

26.2.1.2 CDBSDA — Software driver address 



This tujo-byte field of the CDB must contain the starting 
address of the device driver program that controls the 
device. It is this address that is used to access the 
individual device driver entry points, Thereforsi this entry 
must be provided in every CDB. The format of the device 



26. 2. 1. 3 CDBHAD — Hardware address 



These tuo bytes of the CDB are intended to contain the 

lowest address of the hardware device (PIA or ACTA) used to 

interface with the external device. The actual usage of this 
CDB entry depends exclusively on the device driver program. 

The device independent I/O functions do not access this 
entry. 

26.2.1.4 CDBDDF — Device descriptor flags 



The CDBDDF byte contains the basic description about the 
types of I/O accesses that the device can perform. The 
format of the CDBDDF byte is shown below: 



W 



Default binary format 
Logical sector I/O flag 
System console flag 
Rewindable device flag 
File— type device flag 
Input device flag 
Output device flag 
Reservable device flag 



These flags are constant once defined. The flags ars 
interrogated by the various device independent I/O functions 
in order to verify, that the requested function can be 
performed on the specified device. The properties controlled 
by the various bits of the CDBDDF are explained below. 
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R (Bit 7) — Reservable device flag 

This bit determines uihether a device can be 
reserved by multiple lOCBs at the same time. Certain 
devices* like diskette devices* by nature of their 
operation/ can allow input/output accesses to be 
performed from different callers (lOCBs). Other 
devices. like a line printer, cannot logically allow 
multiple output accesses from different lOCBs to be 
processed. If the "R" bit is set to one, it means 
that the device is reservable. In other uiords, only 
one lOCB can communicate with the device at a time. 
If the "R" bit is set to zero, it means that the 
device is non— reservable (i. e. , the device can 
communicate with multiple lOCBs). 

(Bit 6) — Output device flag 

This bit indicates whether a device can be used 
by output functions. If the "0" bit is set to one, 
then the device can be used for output. If the "0" 
flag is set to zero, then the device cannot be used 
for output, 

1 (Bit 5) — Input device flag 

This bit indi.cates whether a device can be used 
by input functions. If the "I" bit is set to one, 
then the device can be used for input. If the "I" 
flag is set to zero, then the device cannot be used 
for input. 

F (Bit 4) — File-type device flag 

This bit determines whether or not a device can 
open and close files. A file-type device (e.g., 
diskette drive, and cassette or paper tape 
reader/punch) will be handled differently by the 
.OPEN and .CLOSE functions than a non-f i le-type 
device (e.g., console printer, line printer, 
keyboard). In addition to having FDR processing 
performed on them, file-type devices are also 
sensitive to end-of-file records. Non-file-type 
devices are not sub-ject to FDR processing, nor are 
end— of— file records read from them or written to 
them. A file-type device is indicated by the "F" bit 
being set to one. Non-file-type devices have the "F" 
bit set to zero. 
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W (Bit 3) — Reuindable device flag 

This bit indicates uhether the . REWND function 
is valid for the device. In the current version of 
MDOS, it may appear as if the "W" flag and the ''L" 
flag are redundant^ because only the diskette device 
csn be used for logical sector I/O and only the 
diskette device can be "rewound"; however, in order 
to allow for expansion. the .REWND Function's 
processing depends on the "W" flag. If the "W" flag 
is set to one. the device can be rewound. If the "W" 
flag is set to zero, the device cannot be rewound. 

S (Bit 2) — System console flag 

This flag distinguishes the systeni censsle rvuiu 
all other devices. This is needed since the record 
input function does special processing for the 
certain control characters which are treated 
differently when being-, input from another device. 
These special characters ars described in section 
25.3.4. If the "S" bit is set to one. the device is 
the system console. If the "S" bit is set to zero, 
the device is not the system console. 

L (Bit 1) — Logical sector I/O flag 

This flag is used to distinguish the diskette 
drives from all other devices. Since the two 
specialized I/O calls, . GETLS and . PUTLS, ars only 
valid for the diskette drives, a flag is necessary 
that identifies that device. If the "L" flag is set 
to one. logical sector I/O is valid (i.e.. the device 
is the diskette drive). If the "L" flag is set to 
zero, logical sector I/O is invalid (i.e.. the device 
is not the diskette drive). 



J 
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D (Bit 0) — Default binary record format flag 



Some devices 
eight-bit data bytes, 
special record forma 
binary records can be 
process eight— bit da 
record format. The " 
record format to be 
records. The FMT fiel 
IOCS has a special va 
binary record format t 
device. If the "D" 
record format will 

Conly if binar 
"D" bit is set 



format 
If the 
record 
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ssed). If the device 
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26. 2. 1. 5 CDBVDT — Valid data types 



This byte of the CDB is an extension of the CDBDDF 
entry. It contains some additional flags that govern the 
types of I/O accesses that can be made on the device. The 
format of the CDBVDT entry is shown belouj. 

7 6 5 4 3 2 10 
IN! IB! ! 

Not used (=0) 

Binary device flag 

Not used (=0) 

Non-file format flag 



The properties controlled 
CDBVDT entry are explained below. 



by the various bits of the 
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N (Bit 7) — Non-file format flag 

This bit indicates whether or not the device can 
be used to perform FDR processing. Certain devices 
(i.e.. those with the file-type bit set to zero in 
CDBDDF) can never perform FDR processing; howeveri 
devices which are file-type devices can* in some 
cases* be used in either the file format or the 
non— file format mode (see lOCDTT description* section 
25.3.1.2). If the "N" bit is set to one* then the 
device can be used in the non-file format mode. If 
the "N" bit is set to zero, then the device cannot be 
used in the non— file format mode. The diskette drive 
is an example of a device that can only be used in 
the file format mode. The console reader is an 

ex^mpxt; w T~ 4 u tr V X u er wtiou usii wc wacu aii 7^v*ici iiiwuc 

The line printer is an example of a device that can 
only be used in the non— file format mode. 

NOT USED (Sits 3-6* 0-1) — Reserved area 

These bits of the CDBVDT byte are reserved for 
future expansion. They must be zero. 

B (Bit 2) — Binary device flag 

This bit indicates whether a device can process 
eight-bit data or not. If the "B" flag is set to 
one. then eight-bit data are valid. If the "B" flag 
is set to zero* then eight-bit data are invalid. 

26.2. 1.6 CDBDDA — Device dependent area 



These tujo-bytes of the CDB are available to the device 
drivers as working storage. For the MDOS-supported devices* 
this field has been provided for future expansion. For other 
devices, this field can be used for whatever purposes are 
deemed appropriate. 

26.2. 1. 7 CDBWST — Working storage 



These two-bytes of the CDB are available to the device 
drivers as working storage. 

26.2.2 Device drivers 



Each device type that is to be accessed via the device 
independent I/O functions (section 25.3) must have its own 
driver program. All device drivers must be accessible for 
the following five functions: 
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1. Turn the device on< 

2. Turn the device off* 

3. Perform device initialization. 

4. Perform device termination* 

5. Input and/or output a single character. 



Not necessarily all of the five functions apply to each 
dsvicej houfever* an entry point aiust be provided in each 
device driver for each of the five functions, regardless of 
whether or not the function is performed. 

Since the only address that is available to the device 
independent I/O functions is the starting address of the 
device driver (CDBSDA of CDB>, the following convention must 
be used by each device driver. The starting address 
contained in the CDBSDA entry must be the 
beginning of a jump table. one jump for 
functions listed above. An example of such 
given belou: 



address of the 

each of the five 

jump table is 



DVDRV* 


EQU 


* 




JMP 


DEVON 




JMP 


DEVOFF 




JMP 


DEVI NT 




JMP 


DEVTRM 


DEVID 


EQU 


* 



ADDRESS KEPT IN CDBSDA 
DEVICE ON ROUTINE 
DEVICE OFF ROUTINE 
INITIALIZATION ROUTINE 
TERMINATION ROUTINE 
CHARACTER I/O ROUTINE 



Each entry point to the device driver is accessed from 
the device independent I/O functions by executing an indexed 
subroutine call. The offset <index value) is defined by the 
displacement of the entry point from the beginning of the 
device driver. Since these offsets must be the same for all 
device drivers, a set of system symbols is defined in the 
MDOS equate file for the device driver entry point offsets. 

The device on and off entry points are accessed at the 
beginning and at the end of every record I/O function call 
(. GETRC and .PUTRC). These entry points allow the device 
driver to turn the device on and off. respectively. If such 
actions are not defined for the device, then the entry points 
should jump to a routine which simply exits the driver with a 
"no error" status condition. 

The device initialization and termination entry points 
are called once by the .OPEN and .CLOSE functions, 
respectively. These entry points are intended to allow 
leader to be punched on a paper tape device, for example. If 
such actions are not defined for the device, then the entry 
points should jump to a routine which simply exits the driver 
with a "no error" status condition. 



The character I/O entry point to the driver is used to 
receive or transmit one byte of data. The transmitted or 
received byte is passed 



between the I/O functions and the 



Page 26-09 



INPUT/OUTPUT PROVISIONS 



26. 



Device Independent I/O 



device driver in the "B" accumulator. For devices that can 
process both input and output, the IOCS must be interrogated 
("10" of lOCDTT) by the device driver to determine uihich 
function is to be performed. Since the index register is 
required to execute the jump to subroutine instruction, the 
address of the IOCS is passed to the device driver using the 
folloii;ing convention: 

JSR DV*IO, X . CALL TO DRIVER 

FDB lOCPTR . POINTER TO IDCB'S POINTER 

BCS ERROR . RETURN HERE FROM DRIVER 



lOCPTR 



FDB 



IOCS 



ADDRESS OF lOCB 



With this convention, the address pushed on the stack as 
a result of executing the jump to subroutine instruction will 
point to the double byte which contains a pointer. 



It is the 



data at the address iden' 



• ed 



;y the pointer that is the 
actual address of the lOCB itself. As a result. the device 
driver cannot just execute a return from subroutine 
instruction to get back to the I/O function. This calling 
sequence applies to all entry points into all device drivers. 
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turning to the I/O function, the device driver 

or status condition indicating the state of 

action. Two things must be configured by the 

ate an error. First, the lOCSTA byte of the 

initialized with one of the standard I/O error 

on 25.3. 1. 1). Second, the carry condition 

set to one. If no error occurred, only the 

code must be set to zero. The lOCSTA entry 

need not be changed to zero since the I/O 

et a normal return status before exiting. The 

registers need not be preserved by the device 

ase. The "B" register returns the character 

he device driver was called upon for an input 



26.2.3 Example of device driver 



The following example illustrates a CDB and its 
associated device driver for a high-speed papertape reader 
(specifically, the EXORtape VBader). The system symbols from 
the MDOS equate file are used throughout this example. 
First, the CDB is shown; 
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* 

* CONTROLLER DESCRIPTOR BLOCK (CDS) 

♦ 

HR*CDB EQU » 

FDB - CDBIOC 

FDB HRDRV* . CDBSDA 

FDB $E404 . CDBHAD 

FCB DD«RES+DD*INP+DD«OCF . 

, FCB VD*NFF+VD«BIN . CDBVDT 

FDB CDBDDA 

FDB O . CDBWST 



CDBDDF 



Logica 
by multipl 
considered 
The paper 
bit "0" of 
reader is s 
a file-type 
"S". and " 
reuiindable 
is not the 
sector I/O. 
identified 



lly. the paper tape 
e lOCBs at the 
to be reservable <B 

tape reader is an 
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ensitive to end-of- 
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The paper tape reader is capable of being used in ^the 
non-file format mode and is capable of transmitting eight-bit 
data to the device. Thus, both bits "N" and "B" of CDBVDT 
are set to one. 

The only other required field of the CDB is the address 

of the device driver in CDBSDA. The remainder of the CDB is 

reserved for expansion or is used for working storage by the 
device driver. 

Next, the device driver itself is shown. Of the five 
entry points that are required by each device driver, only 
two are used for the paper tape reader driver. The other 
three (device on, device off, and device termination) are 
dummy vectors that set a "no error" return status and then 
return to the I/O function. 
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♦DEVICE DRIVER ENTRY POINTS 



HRDRV* EQU 
CLC 
BRA 

* 

CLC 
BRA 

JSR 
* 

CLC 
nfiA 



* 
RETURN 

RETURN 
INITR 

RETURN 

GETCP 
RETURN 



TURN DEVICE ON 

TURN DEVICE OFF 

DEVICE INITIALIZATION 
DEVICE TERMINATION 



BSR 
TAB 
BCC 
TSX 

LDX O, X 
LDX O, X 
LDX 0. X 
LDAA »I«EOM 
STAA lOCSTA. X 
RETURN TSX 

LDX X 
INS 
INS 

JMP 2. X 
* 

* READER INITIALIZATION ROUTINE 
•» 

HR«CDB+CDBDDA 

HR$CDB+CDBHAD 

PTCTL. X 

PTDTA. X 

#*3C 

PTCTL. X 

HR4CDB+CDBDDA 



CHARACTER INPUT 

RETURN WITH CHAR IN "B" 

CC => NO ERROR 

CS => END OF MEDIA (TIMEOUT) 

SET ADR OF FDB FOLLOWING JSR 

GET CONTENTS OF FDB 

GET ADR OF IOCS 

SET END OF MEDIA STATUS 



RETURN TO CALLER 

SET ADR OF FDB FOLLOWING JSR 

ADJUST STACK FOR RETURN 

JUMP TO ADR FOLLOWING FDB 



SAVE INDEX REGISTER 
GET THE PIA ADDRESS 



RESTORE INDEX REGISTER 



INITR STX 

LDX 

CLR 

CLR 

LDAA 

STAA 

LDX 

RTS 
•» 
* INPUT ONE CHARACTER 



GETCP STX HR«CDB+CDBDDA . SAVE THE INDEX REGISTER 

LDX HR*CDB+CDBHAD . GET THE PIA ADDRESS 

LDAA PTDTA. X . CLR INTERRUPT 

LDAA #*34 . STROBE READER 

STAA PTCTL, X 

LDAA #*3C 

STAA PTCTLi X 

CLR HR«CDB+CDBWST . INIT THE TIMEOUT COUNTER 

CLR HR«CDB+CDBWST+1 . AND CLEAR CARRY 

GETCl LDAA PTCTL. X . READY TO READ? 
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GETC: 



MI 



=> YES 
HR«CDB+CDBWST+1 . PL => CHECK TIMEOUT 
SETCl . NE => KEEP LOOPING 



BMI 
• DEC 

BNE 

DEC 

BNE 

SEC 
GETC2 LDAA 

BCS 
* 
* IF ASCII FILEi STRIP PARITY 



HR*CDB+CDBWST 

GETCl . NE => KEEP LOOPING 

. SET CARRY FDR TIMEOUT 
PTDTA, X . GET CHAR 



GETC4 



CS => TIMEOUT 



TSX 

LDX 

LDX 

LDX 
t r\An 

ANDB 
CMPB 
BNE 
ANDA 
GETC3 CLC 
GETC4 LDX 
RTS 



2i X 
0* X 

0, X 

rnnrnc. > 

#7 

#FM«FMA 

GETC3 

#«7F 



GET ADR OF IDCB 

GET BACK TO 1ST LEVEL SUBRTN 

GET CONTENTS OF 2ND FDB 

GET ADR OF IOCS 

PICK UP FILE ATTRIBUTES 

ISOLATE FMT BITS 

ASCII FILE ? 

NE => NO, LEAVE 8 BITS 

STRIP PARITY IF ASCII 

SET STATUS TO OK 



HR«CDB+CDBDDA 



RESTORE X 



26.2.4 Adding a non-standard device 



If the device driver defined in the above example is to 
be used by a user's program with the device independent I/O 
functions/ then the 'only function that is treated differently 
is the . RESRV function. Since . RESRV must be used to link 
the lOCB uiith a known CDB, the .RESRV call is bypassed 
altogether by the user program; however, before the .OPEN 
function is invoked, the IOCS must be parameterized as if it 
had been properly reserved. 



Thus, the lOCGDW entry of the lOCB must be configured to 
contain the address of the CDB uiith which communication is to 
take place. In addition, bit "R" of lOCLUN must indicate 
that the IOCS has been reserved. This information is also 
found in the EXIT CONDITIONS description of the .RESRV 
function (section 25.3.2). 

Once the lOCB has been configured in this manner, the 
other I/O functions can be used in the normal fashion. 



Page 26-13 



CHAPTER 27 



27. OTHER SYSTEM FUNCTIONS 



In the following description of the system functions 
these symbols uiill be used: 

Symbol Meaning 



A A accumulator 
B B accumulator 
X Index register 



FAIIV^f I ^UAS^W^I 



CC Condition code register 

2 Zero flag of condition code register (bit 

2) 
C Carry flag of condition code register 

(bit 0) 
XH ' Most significant byte of X 
XL Least significant byte of X 
B. A The register pair B and A treated as a 

sixteen bit register 

For MD0S09< the registers Y, U and DP are unchanged by 
the system function calls. 

It is assumed that the reader is familiar with what 
system functions ars, how they ave invoked^ what precautions 
must be taken when testing programs using system functions/ 
and how errors are handled by system functions (see section 
24. 8), 

The remainder of this chapter is devoted to the 
description of all system functions not described thus far. 
The description is divided into the following sections; 
register functions. double-byte arithmetic functions, 
character string functions. diskette file functions. and 
miscellaneous functions. 

27. 1 Register Functions 



The register functions ars used by some of the other 
system functions as an extension of the M6800 instruction 
set. Many operations that involve the transfer and exhange 
of information between the register pair "B.A" and the X 
register are made feasible by the fact that the SWI 
instruction (used for accessing system function handler) 
automatically saves all registers on the stack. Since the 
sixteen bit registers ars pushed on the stack least 
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significant byte first/ most significant byte lastj the 
register pair "Bi A" was chosen instead of "A, B". The 
relationship of the B and A registers on the stack is then 
identical to the other sixteen bit registers saved in this 
fashion (for the M6800 only). For the M6S09, it is not 
anticipated that the user will use the register system 
functions as there are instructions to perform most of these 
functions. Howeverj the system function calls remain 
identical between MDOS and MD0S0<5f to allow portability of 
program written initially for the 6S00. 

27. 1. 1 Transfer X to B, A — . TXBA 



The .TXBA function transfers the contents of the 
register into the register pair B. A. 



ENTRY PARAMETERS: 



None. 



EXIT CONDITIONS; 



A contains XL. 

B contains XH. 

X is unchanged. 

CC is indeterminate. 



27. 1.2 Transfer B. A to X — . TBAX 



The . TBAX function transfers 
register pair B. A into the X register. 



the contents of the 



ENTRY PARAMETERS: 



None. 



EXIT CONDITIONS: 



A is unchanged. 
B is unchanged. 
XH contains B. 
XL contains A. 

CC is indeterminate. 



17. 1. 3 Exchange B, A with X — . XBAX 



The . XBAX function 
register pair Bi A with the 



exchanges the 
contents of the 



contents of 
X register. 



the 



ENTRY PARAMETERS: 



None. 



EXIT CONDITIONS; 



A contains entry value of XL. 
B contains entry value of XH. 
XH contains entry value of B. 
XL contains entry value of A. 
CC is unchanged. 



27. 1. 4 Add B to X — . ADBX 
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The . ADBX function adds the contents of the B register 
to the contents of the.X register. The addition Is performed 
as if B were an unsigned binary number. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
X has been incremented by the contents of 

B. 
CC has been set as in a normal unsigned 

addition. 



27. 1. 5 Add A to X — . ADAX 



The . ADAX function adds the contents of the A register 
to the contents of the X register. The addition is performed 
as if A were an unsigned binary number. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
X has bee^n incremented by the coi%tent5 of 

A. 
CC has been set as in a normal unsigned 

addition. 

27.1.6 Add B,A to X — . ADBAX 



The .ADBAX function adds the contents of the register 
pair B. A to the contents of the X register. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
X has been incremented by the contents of 

B> A. 
CC has been set as in a normal unsigned 

addition. 

27.1.7 Add X to B.A — . ADXDA 



The . ADXBA function adds the contents of the X register 
to the contents of the register pair B* A. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS; A has been incremented by XL. 

B has been incremented by XH and C. 
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X is unchanged. 

CC has been set as in a normal unsigned 
addition. 

27. 1. S Subtract B from X — . SUBX 



The .SUBX function subtracts the contents of the B 
register from the contents of the X register. The 
subtraction is performed as if B mere an unsigned binary 
number. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS; A is unchanged. 

S is unchanged. 
X has been decremented by the contents of 

B. 
CC has been set as in a normali unsigned 
subtraction. 



27. 1. 9 Subtract A from X — . SUAX 



The . SUAX function subtracts the contents of the A 
register from the contents of the X register. The 

subtraction is performed as if A ujere an unsigned binary 
number. 

ENTRY PARAMETERS; None. 

EXIT CONDITIONS; A is unchanged. 

B is unchanged. 
X has been decremented by the contents of 

A. 
CC has been set as in a normal unsigned 

subtraction. 

27. 1. 10 Subtract B, A from X — . SUBAX 

The . SUBAX function subtracts the contents of the 
register pair B» A from the contents of the X register. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
X has been decremented by the contents of 

B, A. 
CC has been set as in a normal unsigned 

subtraction. 
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27. 1. 11 Subtract X from B, A — . SUXBA 

The . SUXBA function subtracts the contents of the X 
register from the contents of the register pair B. A. 



ENTRY PARAMETERS; 
EXIT CONDITIONS: 



None. 

A has been decremented by XL. 
B has been decremented by XH and C. 
X is unchanged. 

CC has been set as in a normal unsigned 
subtraction. 



27. 1. 12 Compare B, A suith X — . CPBAX 



The . CPBAX function compares the contents of the 
register pair B, A to the contents of the X register. 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



None. 

A is unchanged. 
B is unchanged. 
X is unchanged. 

CC has been set as in a normal unsigned 
subtraction. 



27. 1. 13 Shift X right — . ASRX 



The .ASRX function shifts the contents of the X register 
to the right by one bit position. Bit 15 is held constant 
and bit is moved into C. 



ENTRY PARAMETERS: 
EXIT CONDITIONS: 



None. 

A is unchanged. 
B is unchanged. 
X is shifted right one bit position. The 

sign bit is propagated into the lower 

bits upon subsequent shifts. 
C contains bit zero of the entry value of 

X. The remainder of CC is 

indeterminate. 



27. 1. 14 Shift X left — . ASLX 



to 



The . ASLX 
the left by 



function shifts the contents of the X register 
one bit position. Bit is filled with zero. 



ENTRY PARAMETERS: 



None. 
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EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
X is shifted left one bit position. Bit 

zero is filled (nith zero. 
C contains bit 15 of the entry value of 

X. The remainder of CC is 

indeterminate. 

27. i. 15 Push X on stack — . PSHX 



The .PSHX function pushes the contents of the X register 
on the current stack. 

ENTRY PARAMETERS; None. 

EXIT CONDITIONS: A is unchanged. 

3 is unchanged. 

X is unchanged. 

CC is unchanged. 

S has been decremented by 2. The 
contents of XL have been pushed on 
the stack folloued by the contents of 
XH. 

27. 1. 16 Pull X from stack — . PULX 



The .PULX function pulls the contents from the stack 
into the X register. 

ENTRY PARAMETERS: None. 

EXIT CONDITIONS: A is unchanged. 

B is unchanged. 
XH contains the contents located at the 

entry value of S + 1. 
XL contains the contents located at the 

entry value of S + 2. 
CC is unchanged. 
S has been incremented by 2. 

27.2 Double-byte Arithmetic Functions 



The double-byte arithmetic functions are used by some of 
the other system functions and the MDOS commands as an 
extension of the M6S00 instruction set. These functions are 
not as general purpose as the register functions* but they 
are useful in special cases. 



A. 



■^-r—rtj. 



OTHER SYSTEM FUNCTIONS 



27. 2 — Dcobis-byfcs Arithmetic Functions 



left as the shift takes place. 
27.2.4 Shift memory left — . MMA 



The . MHA function shifts the contents of a double byte 
in memory to the left by the number of bit positions 
represented by the contents of the A register. The effect is 
to multiply the double byte by a power of 2. The exponent is 
given by the value of the A register. 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



X = The address of the most significant 
byte of a double byte in memory. 

A is unchanged. 

B is unchanged. 

X is unchanged. 

CC is indeterminate. 

The double byte in memory has been 
shifted to the left by the number of 
bits represented by the contents of 
A. Zero bits ave brought in from the 
right as th.e shift takes place. 



27. 3 ChavactsT String Functions 



The character string functions are used by some of the 
more complex system functions and the MDOS commands as macro 
instructions or subroutines. 

27. 3. 1 String move — . MOVE 



The .MOVE function transfers a series of contiguous 
bytes in memory from one location into another location. The 
move is made starting uiith the lowest addressed byte of the 
source string. 



ENTRY PARAMETERS; 



B = The number of bytes to be moved. If 
B is intially zeroi 256 (decimal) 
bytes will be moved.- 

X = The address of the first byte of a 
four-byte parameter packet. The 
parameter packet has the follouiing 
format: 
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EXIT CONDITIONS: 



Address of 
the 
source string 



2 
3 



Address of 

the 

destination string 



A is indeterminate. 

8=0. 

X is unchanged. 

CC is indeterminate. 



The 



The 



of 



the 



source 



and 



addresses 

destination strings in the parameter 
packet have both been incremented by 
the entry value of B. 

source string has been moved into the 
destination string. 



27. 3. 2 String comparison — . CMPAR 



The .CMPAR function compares a series of contiguous 
bytes in memory from one location with a series of bytes at 
another location. The comparison is made starting with the 
lowest addressed byte of the source string. 



ENTRY PARAMETERS: 



B = 



X = 



The number of bytes to be compared. 

If B is intially zero, 256 (decimal) 

bytes uilll be compared. 

The address of the first byte of a 

four— byte parameter packet. The 

parameter packet has the following 

format: 





1 





Address of 


1 
1 


7 


the 
source string 


i 




Address of 


1 
t 




the 
destination string 


1 



EXIT CONDITIONS: 



A is indeterminate. 

B a The number of bytes remaining in the 

string which did not compare. • If B 

is zero* the strings were identical. 

If the strings mis-compared on the 

first bytei B is unchanged. 



Page 27-09 



OTHER SYSTEM FUNCTIONS 






zT 5wT**Tly ?*yTlC 



:iorss 



X is unchanged. 
Z = 1 if the St 



rings 

The remainder of 
Z = if the strin 

remainder of CC 
The addresses of 

destination str 

packet have both 

the entry valu 

strings compare 

source string 

the address 

following the mi 

destination st 

of the mis-comparison. 
The source and destination 
unchanged. 



compared (3 = 0). 

CC is indeterminate, 
gs mis-compared. The 
is indeterminate. 

the source and 
ings in the parameter 

been incremented by 
e of B if the two 
d. Othertuise. the 
pointer will contain 
of the character 
5-compar ison* and the 
ring pointer will 



^ \^ V ^ i 



strings ars 



27.3.3 Character-fill a string — . STCHR 



The . STCHR function stores a specific character into a 
series of contiguous bytes in memory. 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



A = The character to be stored into the 

string. 
B = The number of bytes to be filled with 

the character. If B is initially 

zero. 256 (decimal) bytes will be 

filled. 
X = The address of the first byte of the 

string to be filled. 

A is unchanged. 
B = 0. 

X is unchanged. 
CC is indeterminate. 

The string is filled with the character 
in A. 



27.3.4 Blank-fill a string — . STCHB 



The .STCHB function stores blanks <$20) into a series of 
contiguous bytes in memory. 



ENTRY PARAMETERS: 



B = The number of bytes to be filled with 
blanks. If B is initially zero, 256 
(d-ecimal) bytes will be filled. 

X = The address of the first byte of the 
string to be filled. 



EXIT CONDITIONS: 



A = $20 < space), 
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B = 0. 

X is unchanged. 

CC is indeterminate. 

The string is filled with blanks. 

27.3.5 Test for alphabetic character — .ALPHA 



The . ALPHA function examines the character in .the A 
register for being an upper case alphabetic character (A-Z). 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



A = The character to be tested. 

A is unchanged. 
B is unchanged. 
X is unchanged. 
C = if A contains a valid alphabetic 

character. The remainder of CC is 

indeterminate. 
C = 1 if A contains an invalid alphabetic 

character. The remainder of CC is 

indeterminate. 



27.3.6 Test for decimal digit — . NUMD 



The . NUMD function examines the character in the A 
register for being a valid ASCII decimal digit <0-9). 



ENTRY PARAMETERS: 



EXIT CONDITIONS: 



A = The character to be tested. 

A is unchanged if it contained an invalid 
digit. Otherwise, A contains the 
binary equivalent of the decimal 
digit (bits 4-7 will be zero). 

B is unchanged. 

X is unchanged. 

C = o if A contained a valid digit. The 
remainder of CC is indeterminate. 

C = 1 if A contained an invalid digit. 
The remainder of CC is indeterminate. 



27.4 Diskette File Functions 



The diskette file functions can be used in conjunction 
with the device dependent I/O functions (section 25.2) for 
diskette accessing. These functions are used by the device 
independent I/O functions to perform directory searches and 
diskette space allocation and deallocation. The MDOS 
commands use these functions for changing file names and 
attributes and for loading programs from memory-image files 
from the diskette into memory. 
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Ail of the functions described in this section require a 
twenty-five byte parameter table called the diskette file 
table, or DFT. The format of the table is shown here so that 
it will not have to be repeated for each function. It will 
be seen that the first sixteen bytes of the DFT are identical 
in format uiith an flDQS directory entry. Also* the entire DFT 
is of the same format as part of an IOCS (starting with 
lOCLUN and ending with lOCSBE). The contents of the 
individual fields are not described in this section since 
they have been adequately discussed in sections 24.1.4 and 
25.3.1. All of the diskette file functions will change the 
diskette controller variables below location $0020. 
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00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 

OE 

OF 

10 

11 

12 

13 

14 

15 

16 

17 

IB 



Logical unit number 



File Name 



Suffix 



Physical sector number 
of file's RIB 



W I D ! S I C ! N ! 

(reserved; =0) 



FMT 



(reserved; =0) 



PSN ! EN 

(reserved; =0) 



Initial new file size 



Sector buffer 
start address 



Sector buffer 
end address 



LUN 



NAM 



SUF 



RIB 



FDF 



File descrip- 
tor flags 



RES 



DEN - Directory 

entry number 



SIZ 



- SBS 



- SBE 
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27. 4. 1 Directory search — . DIRSM 



The .DIRSM function performs directory searches based on 
various criteria. This function can be used for findingi 
creating, or deleting directory entries on an MDOS diskette. 

ENTRY PARAMETERS: B contains a function code that specifies 

the action to be performed by .DIRSM. 

X = The address of the DFT. All calls to 
. DIRSM require that LUN contains the 
logical unit number to be accessed 
<ASCII number 0-3. $30-«33), that SBS 

uuut#Aj.jia ifiitr ^u&t'irxn^ auui ess u t~ a 

12S (decimal) byte sector buffer, and 
that SBE contains the ending address 
of the sector buffer. If the sector 
buffer is larger than a single 
sector, only the first 12S bytes mill 
be used. 

The following function codes for the B 
register are defined: 

B = 1 indicates to search , for and 
retrieve the next. non— deleted 
directory entry. The DFT must have 
DEN = for the initial call. The 
D£N must then remain unchanged for 
subsequent calls since it is used to 
determine where to resume the search. 
The contents of the sector buffer 
must also remain unchanged between 
successive calls for this function 
code. 

B = 2 indicates to search for and 
retrieve a directory entry with a 
specific file name and suffix. The 
DFT entries NAM and SUF are used to 
specify the file name. 

B = 4 indicates to create a new unique 
directory entry of a given name and 
suffix. Initial diskette space 
allocation is performed if the 
directory entry is created. The DFT 
entries NAM and SUF are used to 
specify the directory entry to be 
created. A search of the directory 
is performed for this entry to ensure 
that it does not already exist. The 
DFT entries FDF and SI2 must also be 
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spec if ied. 
inherent 
attributes 
to the fil 
the initia 
be allocs 
default 3 
performed, 
allocation 
the conte 
number of 



FDF must specify both the 

and the changeable 

to be initially assigned 

e. SI2 is used to describe 

1 diskette space that is to 

ted. If SIZ is lero, the 

pace allocation uiill be 

If SIZ is non-zero, the 

will be performed using 

nts of SIZ as the .minimum 

sectors to be allocated. 



B - S indicates a similar function to be 
performed as for the B=4 case; 
hoiiievsri in the event that a 
directory entry already exists with 
the NAM and SUF found in the DFT, 



that 



file's 

1 1 



directory 
information will be returned 
DFT. Otherwise. the 
parameterized identically to 
case. 



entry 

in the 

DFT is 

the B=4 



B = 16 <«10) indicates that a specific 

directory entry is to be deleted from 

the directory. The DFT entries NAM 

>and SUF are used to specify the entry 

to be deleted. 

B = 32 <*20) indicates to search for the 
next* non-deleted d,irectory entry 
with a specific set of file 
attributes. Entries encountered with 
different attributes will not be 
returned by the search. The DFT must 
have DEN = O for the initial call. 
The DEN must then remain unchanged 
for subsequent calls since it is used 
to determine where to resume the 
search. The contents of the sector 
buffer must also remain unchanged 
between successive calls for this 
function code. The FDF entry must 
contain the specific attributes to be 
searched for. 



EXIT CONDITIONS: 



A is indeterminate. 

B contains the return 
following return 
defined: 



status, 
statuses 



The 
are 



B = indicates that no errors occurred 
(normal return). 
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B = 1 indicates that the directory entry J 
specified by LUN, NAM* and SUF Siias 
not found in the directory. 

B = 2 indicates that B contained an 
invalid function code upon entry to 
. DIRSM. 

B = 3 indicates the. physical end of the 
directory was encountered during a 
"search for next directory entry" 
request (Entry value of B = 1 or 32). 

B = 4 indicates that the directory is 
full and cannot accomodate a neui 
entry. 

B = 5 indicates that insufficient 
diskette space exists to satisfy the 
initial space requirements of SIZ 
ujhen attempting to create a new 
directory entry. The , ALLOC function 
(section 27.4.4) should be consulted 
for a full description of the 
allocation scheme and the reasons far 
arriving at this error. ^ 

B = 7 indicates that an attempt was made 
to create a duplicate entry in the 
directory. The file name identified 
by LUN. NAMi and SUF already exists 
in the directory. 

B = 8 indicates that a new directory 
entry was created as specified by 
LUN. NAMi and SUF. 

B = 9 indicates that an attempt tuas made 
to delete a protected file. 

X is unchanged. 

C = if no errors occurred <B = O). The 
remainder of CC is indeterminate. 

C = 1 if an error occurred (B not zero). 
The remainder of CC is indeterminate. 

The DFT entries were changed in the 
following manner depending on the 
various entry values of B: 

B = 1. If a non-deleted directory entry 
was found, then NAM, SUF, RIB, FDF, 
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and RES contain the full image of the 
directory entry. DEN will contain 
the computed directory entry number. 
The remainder of the DFT is 
unchanged. The sector buffer 
contains the current directory 
sector. If no directory entry utas 
found* the directory entry fields NAM 
through RES* inclusive* u/ill be 
unchanged. DEN and the contents of 
the sector buffer are indeterminate. 

B = 2. The DFT is affected the same as 
for B=l. 

B = 4. If a neui directory entry was 
created* RIB and DEN uill reflect the 
appropriate values for the new entry. 
The sector buffer uiill contain the 
current directory sector. If a new 
entry was not created (duplicate file 
name)* then the DFT will be affected 
in the same way as for B=l. 

B = S. The exit conditions for this case 
are the same as for B=4. In 
addition* if a duplicate entry 
'already existed in the directory* the 
directory entry fields NAM through 
RES* inclusive* will contain the full 
image of the duplicate entry. DEN 
will also contain the duplicate 
entry's directory entry number. 

B = 16. If the entry is deleted* the 
complete directory entry will be 
returned in fields NAM through RES* 
inclusive. In addition* RIB will be 
zero. The contents of the sector 
buffer are indeterminate. If the 
entry is not deleted* all parameters 
except RES and DEN will be unchanged. 
RES. DEN and the contents of the 
sector buffer will be indeterminate. 

B = 32. The DFT is affected in the same 
way as for B=l. 

27.4.2 Change file name/attributes — .CHANG 

The .CHANG function allows a directory entry to have its 
name* suffix* and/or attribute fields changed. 
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ENTRY PARAMETERS: 



B = 



A functi 
action t 
O is set 
the fil 
d irector 
onet th 
attribut 
Bits 2- 
zero. B 
of each 
used to 
attribut 



on code that specifies the 

o be taken by .CHANG. If bit 

to one> .CHANG uill change 

e name and suffix fields of a 

entry. If bit 1 is set to 

function will change the 

field of a directory entfy. 

are not used and should be 

its and 1 are independent 

other. Thus, . CHANG can be 

change file name< suffix* and 

es at the same time. 



'"^ 



X = The address of a file table packet. 
The sacket has the following fornsat: 



O 

1 



Address of 
old DFT 



Address of 
n eu> DFT 



The "old DFT" contains t 
and SUF fields of 
directory entry that 
changed. The SBS 
starting address of a 1 
byte sector buffer, SBE 
ending address of the se 
If the sector buffer i 
one sector; only the fir 
will be used. The "ne«jj 
the information that is 
into the directory en 
both DFTs must be the 
number 0-3, $30-$33). 
must contain NAMj SUFj 
fields as indicated by 
code in the B register 
buffer is not require 
DFT. 



he LUN, NAMi 


an existing 


is to be 


contains the 


2Q (decimal) 


contains the 


ctor buffer. 


s larger than 


st 128 bytes 


DFT" contains 


to be placed 


try. LUN in 


same (ASCII 


The new DFT 


and /or FDF 


the function 


A sector 


d by the neuj 



EXIT CONDITIDNS: 



A is indeterminate. 



B contains the return status. The 
following return statuses are 
defined: 

B = indicates that no errors occurred 
(normal return). 
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B = 1 indicates that B contained an 
invalid function cods upon entry to 
. CHANG. 

B = 3 indicates that the directory entry 
specified by LUN, NAM, and SUF of the 
eld DFT could net be found in the 
directory. The old DFT directory 
entry must exist in order for the 
change to be possible. 

B = 4 indicates that the directory entry 
specified by LUN, NAM, and SUF of the 
neui DFT already existed in the 
directory. The new DFT directory 
entry must have a unique file name 
and suffix (only if changing the old 
entry's ,file name). 

B = 5 indicates that an invalid attribute 
change tuas attempted. Only the 
changeable attributes (system file, 
turite protection, delete protection) 
can be changed. The inherent 
attributes of a file remain constant 
for the duration of the file's 
existence. 

X is unchanged. 

C = if no errors occurred (B = 0). The 
remainder of CC is indeterminate. 

C = 1 if an error occurred (3 not zero). 
The remainder of CC is indeterminate. 

The four-byte file packet is unchanged. 

The old DFT and its sector buffer have 
been changed as a result of 
performing a directory search (.DIRSM 
tuith B = 2). The new DFT has been 
changed as a result of performing a 
directory search (.DIRSM with B = 4); 
however, no diskette space allocation 
tuas performed. A file name change is 
affected by deleting the old 
directory entry and by creating a new 
directory entry. Thus, the directory 
entry's DEN (and its position within 
the directory) may have changed; 
however, no space is deleted or 
real located. 
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27. 4. 3 Load program into memory — . LOAD 



The .LOAD function reads a program from a memory-image 
file from the diskette into memory. Control can be passed to 
the resident debug monitor, to the calling program, or to the 
loaded program. In addition, the program can be loaded into 
the User Memory Map of EXORciser II systems with the dual 
memory map configuration. 

The .LOAD function does not verify that memory exists 
for the areas into which a program gets loaded. Programs 
ujhich load above location *iF and below the end of contiguous 
memory known to MDOS are guaranteed that memory exists since 
the memory was sized during riDGS initial i zaticn; however.- 
programs loading beyond the end of contiguous memory known to 
MDOS or programs loading into the User Memory Map of an 
EXORciser II system with the dual memory map configured avs 
not guaranteed that memory exists. The operator is 
responsible for knowing where memory is configured in his 
system and where his programs are loaded. Also, due to the 
nature of the diskette controller, it is not possible for the 
.LOAD function to compare what is read from the file with 
what is stored into memory. Only diskette controller read 
errors can be detected during the load process. 

Programs brought into memory from the diskette will be 
loaded in multiples of- eight bytes. This fact must be 
considered when programs ars loaded into adjacent blocks of 
memory close to other programs, or if programs ars loaded 
into the upper end of a block of memory. 

£js}-rRY PARAMETERS: S = A function code that specifies the 

action to be performed by . LOAD. 
This action includes selecting the 
memory map; checking the limits of 
the loaded program against the memory 
map; and the passing of control to 
the debug monitor, loaded program, or 
calling program. The following 
function codes are defined: 

Bit 0=1 indicates that control is to be 
given to the loaded program at its 
starting execution address as 
obtained from the file's RIB. Bit 
is mutually exclusive with bits 1 and 
2. 

. Bit 1 = 1. indicates that control is to be 
given to the resident debug monitor 
after the program is loaded. Bit 1 
is mutually exclusive with bits and 
2. 



Page 27-20 



OTHER SYSTEM FUNCTIONS 27.4 — Diskette File Functions 

Bit 2=1 indicates that control is to be 
. . given to the loaded program at a 

starting execution address specified 
in the DFT. not at the address 
contained in the file's RIB. The 
starting execution address must be 
specified in DEN of the DFT. Bit 2 
is mutually exclusive tuith bits O and 
1. 

Bit 4=1 indicates that the program can 
only be loaded above the resident 
HDDS (location SIFFF) and below the 
last location of contiguous memory 
established during MDOS 
initialization. Programs loaded in 
this manner require an additional 
eight bytes of memory beyond the last 
address loaded into by the program. 
The MDOS variable ENDUS* mill be 
changed to reflect the last address 
loaded into by the program. The MDOS 
SUI vector uiill be unchanged to allou 
access to MDOS system functions. Bit 

4 is mutually exclusive with bits 5 
and 7. 

Bit 5=1 indicates that the program can 
only be loaded into the User Memory 
Map of an EXORciser II system with 
the dual memory map configuration. 
The MDOS SWI vector will be restored 
to point back to the debug monitor if 
control is passed to the loaded 
program or to the monitor. If 
control is returned to the calling 
program* the MDOS SWI vector will be 
unchanged. The only requirement 
placed on programs loading into the 
User Memory Map of a dual memory map 
configuration is that the ending load 
address not be greater than *FFFF. 
OtheruiisBi any memory locations 
(*0000-FFFF) can be loaded into. Bit 

5 is mutually exclusive with bits 4 
and 7. 

Bit 6=1 indicates that no directory 
search is to be performed. The RIB 
entry of the DFT contains the 
physical sector number of the RIB of 
the file from which the program is to 
be loaded. 
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Bit 7=1 indicates that the program can 
be loaded anywhere in memory above 
location $1F. The only other 
requirement is that the ending load 
address not exceed $FFFF. No checks 
are made for overlaying the resident 
MDOS or for loading into 
discontiguous memory. As a result, 
the MDOS SWI vector is restored to 
point back into the debug monitor, 
making MDOS system functions 
unaccessible. This function requires 
one' of the control passage bits (0, 
1, or 2> to be set to one. Control 

mUS'C Oe p^ssea su Bii^iiBi wiitr iu<=u = w 

program or to the debug monitor. 
Control cannot be returned to the 
calling program. Bit 7 is mutually 
exclusive loith bits 4 and 5. 



If none of bits 0-2 av^s set, then control 
will be returned to the calling 
program after the program is loaded. 



X = The address of 
the . LOAD f unct 
contains the 
be accessed 
$30-«33), tha 
starting addres 
byte sector b 
contains the en 
sector buffer 
is larger than 
first 128 byt 
all cases but o 
the DFT must 
name and suffix 
the Bit 6 cas 
required. Ins 
sector number 
be placed into 



the DFT. All calls to 
ion require that LUN 
logical unit number to 
(ASCII number 0-3, 
t SBS contains the 
s of a 128 (decimal) 
uffer, and that SBE 
ding address of the 
If the sector buffer 



one sector, only the 
es mill be used. For 
ne (Bit 6 set to 1), 
also contain the file 
in NAM and SUF. For 
e, NAM and SUF are not 



tead, 
of the 
RIB. 



the physical 
file's RIB must 



EXIT CONDITIONS: 



A is indeterminate. 

B contains the return status. The 
following return statuses ars defined 
(only if control is returned to the 
calling program): 

B = indicates that no errors occurred 
(normal return). 

B = 1 indicates that B contained an 
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invalid function code upon entry to 
.LOAD. An invalid function may be 
one that is not defined, or use of 
more than one of the mutually 
exclusive bits. This error will also 
occur when attempting to load into 
the User Memory Map in a system which 
does not have the dual memory map 
configured. 

B = 3 indicates that the directory entry 
specified by LUN, NAMi and SUF was 
not found in the directory. 

B = 4 indicates that the directory enwry 
specified by LUNj NAM/ and SUF does 
not have the memory— image format. 
Only programs from memory— image files 
can be loaded from the diskette. 

B = 5 indicates that an attempt was made 
to load a program into an invalid 
range of memory. If bit 4 was set, 
the program must load above $1FFF and 
eight bytes below the end of 
contiguous memory. If bit 5 was set, 
the program must load within* the 
range *0000-*FFFF, inclusive, in the 
User Memroy Map of an EXORciser II 
system with the dual memory map 
configured. If bit 7 was set, the 
program must load within the range 
$20— *FFFF, inclusive. 

B = 6 indicates that the starting 
execution address is invalid. The 
starting execution address must be 
within the range of memory loaded by 
the program. 

B = a diskette controller error status 
(SSl-^SV) if a diskette controller 
error occurred during the load 
attempt. This status can only be 
returned if control was to be passed 
back to the calling program (Bits 0-2 
all zero and Bit S zero in entry 
value of B) or if the program was to 
be loaded into the User Memory Map of 
a dual memory map configuration and 
executed (Bit 5 set to one and bits 
or 2 set to 1). Otherwise, any 
diskette controller errors that are 
detected while the program is being 
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loaded will cause the two-character 
diskette controller error message to 
be displayed and control passed to 
the debug monitor. These 
two-character error messages are 
discussed in detail in section 28. 1. 

X is unchanged if control is returned to 
the calling program (Bits 0-2 all 
zero in entry value of B). 
Otherwise. X will contain the 
starting load address of the program 
(lowest address loaded into). 

C = if no errors occurr-ed (3 = O). The 
remainder of CC is indeterminate. 

C = 1 if an error occurred (B not zero). 
The remainder of CC is indeterminate. 

S is configured depending on which range 
of memory is loaded into. If loading 
above the resident MDOS (Bit 4 set to 
one in entry value of B)i the stack 
pointer will contain the highest 
address loaded into (eight bytes , 
greater than the highest program 
location; twenty bytes for MD0S09). 
If loading over the resident MDOS or 
into discontiguous memory (Bit 7 set 
to one in entry value of B). the 
stack pointer will contain the 
address of the EXbug stack area. If 
loading into the User Memory Map of 
an EXORciser II system with the dual 
memory map configured. the stack 
pointer will contain the highest 
address loaded into. 

The DFT has been changed as if a 
directory search has been performed 
(.DIRSM with B = 2). In addition, 
RES contains the starting load 
address and DEN contains the starting 
execution address as found in the 
file's RIB. The DFT contents can 
only be accessed if control is 
returned to the calling program. 

If the resident debug monitor is given control (Bit 1 
set to one in entry value of B). the pseudo registers are 
initialized as follows: .' 
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Pseudo register Contents 



P Starting execution address 

S See description of S above. Contents 

vary depending on load mode. 

X Starting load address. 

A. BiC Indeterminate. 

Y Indeterminate <«D0S09) 

L>=S MD0S09 only 

DP=0 MD0S09 only 

This feature facilitates starting the execution of a program 
from the debug monitor since the starting execution address 
need not be remembered by the operator; however.- caution must 
be exercised if programs are loaded into the User Memory Map 
of an EXORciser II iiiith the dual memory map configured. 
Since the stack pointer contains the address of the last 
loaded program location. use of the debug commands ";P" or 
";N" mill cause seven locations of the program to be 
destroyed. This may alter program data or instructions. It 
is recommended that the stack pointer first be changed via 
the "iS" command; that the "nnnn; G" command be used to 
initiate execution; or that stack area be provided at the end 
of the program area. For programs not loaded into the User 
Memory Map of an EXORciser II system with the dual memory map 
configured, this precaution does not apply. 

Particular attention should be placed on programs that 
load into the highest memory address *FFFF. Since the 
diskette controller can only load programs in a multiple of 
eight bytes. such programs should have, a starting load 
address that is a multiple of eight. Otherwise, the 
calculated ending load address will be greater than SFFFr, 
causing an error. 

Caution must also be exercised if MDOS is to be 
reinitialized from the debug monitor after having loaded a 
program. The ABORT or RESTART pushbuttons must first be 
depressed before the debug command "ESOO; G" or "MDOS" is 
executed. 

27.4.4 Allocate diskette space — .ALLOC 



The .ALLOC function allocates contiguous segments of 
diskette space for a file. The file's Retrieval Information 
Block and the system's Cluster Allocation Table sre updated 
to account for the allocated space. Since space allocation 
is performed automatically by the device independent I/O 
functions. the .ALLOC function should only be used by 
programs that are doing physical sector I/O on MDOS 
compatible diskettes. 
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ENTRY PARAMETERS; X = The address of the DFT. 



The DFT must contain the -Pollouing 
parameters: 

LUN must contain the logical unit number 
on which the file resides (ASCII 
number 0-3# «30-$33). 

RIB must contain the physical sector 
number of the file's RIB if the 
directory entry has alTsa6\i been 
created (additional space 
allocation). Otherwise* RIB must 



& c I w 



that no Retrieval Information Block 
exists for the file (initial space 
allocation). 

FDF should have the "C" bit set to 
indicate whether space is to be 
allocated contiguously to the already 
existing space (RIB not zero). If 
the ■ "C" bit is set to zero, 
additional space can be allocated 
anywhere on the diskette. If RIB is 
zero* the FDF entry is not required. 

SIZ must contain the number of sectors 
that are to be allocated. If SIZ is 
zero, the default allocation size (32 
clusters) will be used. 

SBS must contain the starting address of 
a 128 (decimal) byte sector buffer. 

SBE must contain the ending address of 
the sector buffer. If the sector 
buffer is larger than one sector, 
only the first 123 bytes will be 
used. 



EXIT CONDITIONS: A is indeterminate. 



contains the return status. The return 
statuses are taken from the set of 
codes defined for the device 
independent I/O functions. Only the 
system symbols are given here for 
those .return statuses. The exact 
values can be found from the MDOS 
equate file. section 25.3.1.1. or 
section 28. 3. The following return 
statuses are defined: 
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B = indicates that no errors occurred 
(normal return). 

B - I$RIB indicates that the file had an 
existing Retrieval Information Block 
that was invalid (see section 24.2). 

B = I*FSPC indicates that insufficient 
space is available to accommodate the 
allocation requirements. If SI2 
contained a non-zero value at the 
entry to .ALLOC, this error indicates 
that the specific amount of space 
requested could not be allocated. 

Firsti if the file is segmented ("C" 
of FDF set to zero), the number of 
sectors specified in SIZ could not be 
allocated in a single,, contiguous 
block anywhere. Second/ if the file 
is contiguous ("C" of FDF set to 
one), the number of sectors specified 
in SIZ could not be allocated 
contiguously uiith the existing space. 
If SIZ contained a zero value, this 
error indicates that no space is 
available at all on the diskette, or 
that no space is available that is 
contiguous to the existing space, 
depending on "C" being zero or one in 
FDF. If the default of 32 clusters 
(SIZ = 0) cannot be allocated, .ALLOC 
mill allocate whatever space it can 
without generating an error. If SIZ 
is non-zero, an error will be 
generated if the exact number of 
sectors cannot be allocated. 

B = ISSSPC indicates that the file's 
Retrieval Information Block could not 
accommodate the required number of 
SDWs for the requested allocation. 
This error occurs if a file is very 
fragmented. 

X is unchanged. 

C = if no errors occurred (B = O). The 
remainder of CC is indeterminate. 

C = 1 if an error occurred (B not zero). 
The remainder of CC is indeterminate. 

The DFT is unchanged if an error 
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occurred. If no errors occurred* the 
DFT has been changed in the following 
manner. Bytes 3 and 4 contain the 
SDW of the last allocated segment. 
Bytes 5 and 6 contain the starting, 
logical sector number of the last 
allocated segment. SUF contains the 
logical sector number of the logical 
end-of-file, and RIB. if originally 
zero, contains the physical sector 
number of the file's Retrieval 
Information Block. The contents of 
the sector buffer are indeterminate. 



27.4.5 Deallocate diskette space — . DEALC 



The .DEALC function deallocates segments of diskette 
space from a file. The file's Retrieval Information Block 
and the system's Cluster Allocation Table are updated to 
account for the deallocated space. Since space deallocation 
is performed automatically by the device independent I/O 
functions. the .DEALC function should only be used by 
programs that are doing physical sector I/O on MDOS 
compatible diskettes. 



ENTRY PARAMETERS: 



X = The address of the DFT. 



The DFT must contain 
parameters: 



the following 



LUN must contain the logical unit number 
on which the file resides (ASCII 
number 0-3, $30-*33). 

Bytes 1 and 2 must contain the file's 
logical sector number beyond which 
space is to be deallocated. If these 
two bytes contain the value *FFFF. 
then the entire space belonging to 
the file will be deallocated; 
however. in this special case, the 
file's directory entry must already 
have been flagged as deleted. 

RIB must contain the physical sector 
number of the file's Retrieval 
Information Block. 



DEN must contain 
entry number. 



the file's directory 



SBS must contain the starting address of 
a 128 (decimal) byte sector buffer. 
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SBE must contain the ending address of 

the sector buffer. If the sector 

"buffer is larger than one sector. 

only the first 128 bytes will be 

used. 



EXIT CONDITIONS: A is indeterssinate. 



B contains the return status. The return 
statuses aTS taken from the set of 
codes defined for the device 
independent I/O functions. Only the 
system symbols are given here for 
those return statuses. The exact 
values can be found from the MDOS 
eq.uate file. section 25. 3. i. Ij or 
section 28.3. The follou/ing return 
statuses are defined: 

B = indicates that no errors occurred 
(normal return). 

B = I*RIB indicates that the file had an 
existing Retrieval Information Block 
that was invalid (see section 24.2). 

B = I«RANG indicates that the maximum 
referenced logical sector number 
specified in bytes 1 and 2 does not 
belong to the file. That is. the LSN 
specified is greater than the number 
of sectors belonging (allocated) to 
the file. 

B = I«IDEN indicates that an invalid DEN 
was specified. 

B = I*DEAL indicates that an attempt was 
made to deallocate all of a file's 
space (bytes 1 and 2 set to $FFFF)» 
but the directory entry for the file 
was not flagged as deleted. 

X is unchanged. 

C = if no errors occurred <B = 0). The 
remainder of CC is indeterminate. 

C = 1 if an error occurred (B not zero). 
The remainder of CC is indeterminate. 

The DFT is only changed if the all of a 
file's space was to be deallocated. 
In that casej RIB will contain the 
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value zero. Otherii«ise# the DFT is 
unchanged. The contents of the 
sector buffer are indeterminate. 

27.4.6 Display system error message — . MDERR 

The . liDERR function displays on the system console one 
of the standard system error messages contained in the MDOS 
error message file. The error message to be displayed is 
indicated by an index number which is passed in one of the 
registers. This index number luill also be used to modify the 
system error status word (see section 2S. 4). 

Certain error messages contain references to external 
parameters that must be supplied by the calling program 
(e.g.. a file name specification or an address). These 
parameters ar^ shown in the list of error messages below as a 
backslash character (\) followed by a numeric digit which 
indentifies the format of the parameter. When an external 
parameter reference is encountered in the message> the 
corresponding parameter from the calling program will be 
inserted into the message before it is displayed on the 
system console. The following external parameters are 
defined: 
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Parameter reference Calling program specification 



\0 The X register contains the address 

of a standard MDOS file name. Eleven 
bytes comprise an MDOS file name: 
logical unit number (1 byte), file 
name (eight bytes), suffix (two 
bytes) . 

\1 The X register's contents are to be 

converted into four displayafale 
hexadecimal digits. 

v 1 The X re"ist-er contains an address of 

a byte in memory whose contents ave 
to be converted into two displayable 
hexadecimal digits. 

\S The return address on the stack is 

decremented by two (pointing to the 
system call of the error message 
function) and converted into four 
displayable hexadecimal digits. This 
parameter allows the location of the 
call to . MDERR to be incorporated 
into the error message for system 
diagnostic purposes. 

The following table lists the standard error messages 
from the MDOS error message file in order of their error 
message index numbers (number required as entry parameter to 
display the message). This number is not to be confused with 
the two-digit decimal reference number that is displayed with 
each message on the system console. The displayed reference 
number only serves as a quick way of locating the error 
messages' descriptions in Chapter 28. 
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INDEX 
NUMBER 



ERROR MESSAGE 



02 
03 
04 
05 
06 
07 
08 
09 
OA 
OB 
OC 
OD 
OE 
OF 
10 
11 
12 
13 
14 
15 
16 
17 
IS 
19 
lA 
IB 
IC 
ID 
IE 
IF 
20 
21 
22 
23 
24 
25 
26 
27 
28 



»« 


40 


«« 


41 


** 


29 


** 


02 


** 


03 


»■» 


25 


** 


05 


»■» 


2S 


«■» 


31 


»■» 


01 


** 


46 


»* 


07 


-»•» 


12 


** 


13 


*•» 


42 


•»* 


32 


»* 


30 


■»* 


14 


** 


36 


»* 


24 


** 


34 


♦* 


35 


»* 


38 


** 


39 


** 


06 


** 


04 


** 


10 


»* 


33 


»* 


16 


»* 


15 


** 


27 


■»« 


47 


»* 


IS 


»« 


19 


■»* 


11 


** 


20 


»■» 


21 


»» 


17 



»* 37 



DIRECTORY SPACE FULL 

INSUFFICIENT DISK SPACE 

INVALID LOGICAL UNIT NUMBER 

NAME REQUIRED 

\0 DOES NOT EXIST 

INVALID FILENAME 

\0 DUPLICATE FILE NAME 

DEVICE NAME NOT FOUND 

INVALID DEVICE 

COMMAND SYNTAX ERROR 

INTERNAL SYSTEM ERROR AT \a 

OPTION CONFLICT 

INVALID TYPE OF OBUECT FILE 

INVALID LOAD ADDRESS 

SEGMENT DESCRIPTOR SPACE FULL 

INVALID RIB 

INVALID EXECUTION ADDRESS 

INVALID FILE TYPE 

FILE EXHAUSTED BEFORE LINE FOUND 

LOGICAL SECTOR NUMBER OUT OF RANGE 

INVALID START/END SPECIFICATIONS 

INVALID PAGE FORMAT 

INVALID LINE NUMBER OR RANGE 

LINE NUMBER ENTERED BEFORE SOURCE FILE 

DUPLICATE FILE NAME 

FILE NAME NOT FOUND 

FILE IS DELETE PROTECTED 

TOO MANY SOURCE FILES 

CONFLICTING FILE TYPES 

\0 HAS INVALID FILE TYPE 

\0 IS WRITE PROTECTED 

INVALID SCALL 

DEVICE ALREADY RESERVED 

DEVICE NOT RESERVED 

DEVICE NOT READY 

INVALID OPEN/CLOSED FLAG 

END OF FILE 

INVALID DATA TRANSFER TYPE 

END OF MEDIA 



Pan a 
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INDEX 

NUMBER ERROR MESSAGE 

29 *» 22 BUFFER OVERFLOW 
2A *» 23 CHECKSUM ERROR 

2B *» 26 FILE IS WRITE PROTECTED 

2C ** 43 INVALID DIRECTORY ENTRY NO. AT XB 

2D ** 44 CANNOT DEALLOCATE ALL SPACE. DIRECTORY 

ENTRY EXISTS AT \S 

2E ** 45 RECORD LENGTH TOO LARGE 

2F ** 48 CHAIN OVERLAY DOES NOT EXIST 

30 ** OS CHAIN ABORTED BY BREAK KEY 

31 ** 09 CHAIN ABORTED BY SYSTEM ERROR STATUS 

WORD 

32 ** 49 CHAIN ABORTED BY ILLEGAL uPEkAiuk 

33 ** 50 CHAIN ABORTED BY UNDEFINED LABEL 

34 ** 51 CHAIN ABORTED BY PREMATURE END OF FILE 

35 ♦* 52 SECTOR BUFFER SIZE ERROR 

36 ** 53 INSUFFICIENT MEMORY 

In addition. two error messages have specific calling 
sequences. These two messages have the follou/ing format uihen 
displayed: 

INDEX 

NUMBER ERROR MESSAGE 

00 »*UNIF. I/O ERROR — STATUS = \3 AT \8 

01 #*PROM I/O ERROR — STATUS = \3 AT h DRIVE i 

- PSN J 

The first case (index number 00) should be used for 
displaying standard error messages as a result of the device 
independent I/O functions. The . MDERR function expects the X 
register to contain the address of an IOCS. The status byte 
of the IOCS will be decoded into one of the standard system 
error messages shown above. In the event that an illegal 
status code is contained in the lOCB. the error message will 
take on the form as shown above. The "\3" parameter will 
contain the value of the status byte, and the "\S" parameter 
will contain the address of the call to the error message 
function. 

The second case (index number 01) should be used for 
displaying standard diskette controller error messages (as 
returned by . ERE AD, . EWRIT. . MERED. .MEWRT). The .MDERR 
function expects the X register to contain the address of a 
three-byte packet. The format of the packet is shown below: 
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Controller error status 



1 I Address of 
— function call 

2 ! to sector I/O function 



In addition, the . MDERR function will pick up the logical 
unit number and the physical sector number from the diskette 
controller variables in locations $00O0-«0002, inclusive. 
When the error message is displayed, the parameter "h" will 
have been replaced with the address of the call to the error 



message function, the parameter "i 






ujith the logical unit number, and the parameter "j" mill have 
been replaced uith the physical sector number at which the 
error occurred. 



ENTRY PARAMETERS; 



B = The index number of the error message 
as shown in the above tables. 

X may not have to be parameterized. If 
the error message calls for an 
external parameter, X will have to 
contain the parameter or the address 
of the parameter that is to be placed 
into the error message. The contents 
of X depend on the type of message 
displayed as shown in the above 
tables. 



EXIT CONDITIONS: 



A is indeterminate. 

B is indeterminate. 

X is indeterminate. 

C = 0. The remainder of CC 
indeterminate. 



1 s 



The Error Type of the system error status 
word has been changed to contain the 
index number of the displayed error 
message. In addition. the Error 
Status Flag of the system error 
status word has been set to one. 
Section 28. 4 contains a complete 
description of the system error 
status word. 

If the .MDERR function is called with an index number 
for which no valid error message exists, or if the MDOS errar 
message file cannot be accessed on the diskette without an 
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error- a special message mill be displayed. This message has 
the format: 

** INVALID MESSAGE \3 AT \8 

The "\3" parameter will have been replaced with the index 
number of the error message that the . MDERR function was 
trying to display. This may or may not be a valid index 
number, depending on whether or not the MDOS error message 
file could be properly accessed. The "\S" parameter will 
have been replaced with the address of the call to the .MDERR 
system function. In the event that this message is 
displayed, the Error Type portion of the system error status 
word will contain the value *FF (the Error Status Flag will 
also be set to one). 

27. 5 Other Functions 



The remaining system functions are so diverse that they 
fail to fall into one of the previous categories. These 
functions are used by the MDOS commands and are available for 
user programs in order to extract file name or device 
specifications from the MDOS command line, allocate program 
memory in the remaining block of contiguous memory, set the 
system error status word when non-standard error messages are 
displayed so that CHAIN processing will work properly, and to 
return control to the MDOS command interpreter. 

27.5.1 Process file name — . PFNAM 



The .PFNAM function scans a specified input buffer for a 
file name or device specification. The information is 
returned in a format which is called the standard MDOS file 
name format. This format fits into the other parameter 
tables required by the device independent I/O functions 
(IOCS) and the diskette file functions (DFT). The .PFNAM 
function will also recognize family indicators in either the 
file name or the suffix. 

Due to the nature of the free format of the HDDS command 
line, any character that will not be confused with a device 
name indicator, a family indicator, a suffix delimiter, a 
logical unit delimiter, an option field delimiter, or an end 
of line delimiter will be used to terminate the scan for a 
valid file name or device specification. 

The scan will never continue beyond an option delimiter 
(i ) or an end of line delimiter (carriage return), regardless 
of the number of times .PFNAM is called with the scan pointer 
pointing to such a character. 

ENTRY PARAMETERS: X = The address of a file name packet. 
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This packet has the following format: 



Address of 
input buffer 



Address of 
standard 
file name arsa 



EXIT CONDITIONS: 



Since . PFNAM is designed to be called 
fnore than once to extract aiultiple 
file name or device specifications 
from a single input buffer) the first 
pointer of the file name packet, or 
scan pointeri must be pointing to a 
character which previously terminated 
the scan. When .PFNAM is called the 
first time) special care must be 
taken to ensure that the first byte 
of the input buffer is a valid 
terminator (this is automatically 
handled by the MDOS command 
interpreter in using the MDOS command 
line buffer). This character is 
normally a space or a comma; however, 
any other valid terminator will 
suffice. 

The second pointer of the file name 
packet defines where the standard 
file name is to be placed. This area 
must be eleven bytes long. The first 
byte will contain the logical unit 
number. The next eight bytes will 
contain the device name or the file 
name, and the last two bytes will 
contain the suffix. 

A = The character that terminated the 
scan. 

B contains the return status. The 
following return statuses aTe 
defined: 

B = indicates that a standard MDOS file 
name specification was found. 

Bit 0=1 indicates that a family 
indicator was found in the file name. 
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Bit 1=1 indicates that a family 
indicator mas found in the suffix. 

Bit 2 =1 indicates that a device 
specification uias found. 

Bits 3-6 are unused and will be zero. 

Bit 7=1 indicates a null file name u»as 
found. This does not necessarily 
mean that a null suffix or a null 
logical unit number was found. 

X is unchanged. 

CC is indeterminate. 

The scan pointer (first two bytes of file 
packet) will contain the address of 
the character that terminated the 
scan. 

The standard file name pointer (second 
tuio bytes of file packet) will have 
been incremented by eleven (points to 
location following the suffix). 

The standard file name area is only changed if a 
corresponding element is found in the input buffer. Thus/ if 
no logical unit number is found in the input buffer, the 
logical unit part of the standard file name area will not be 
changed. The same is true for the file name and for the 
suffix fields. This feature allows appropriate default 
values for the logical unit nuraberi file name> and suffix to 
be placed into the standard file name area before . PFNAM is 
invoked. Theni after the input buffer is scanned, those 
parts of the file name specification which were not 
explicitly found will assume the default values which were 
unchanged. 

No delimiters of any sort are placed into the standard 
file name area. The presence of device name indicators and 
family indicators is indicated by the return status in the B 
register only. The file name (or device name) and suffix 
will be left justified within the file name area. Unused 
parts of the file name or suffix will be space-filled 
automatically. 

When the scan is initiated, leading spaces in front of 
the file name or device specification will be treated as a 
single space (ignored). Any space. however. encountered 
after the first character of a specification is found will be 
treated as a terminator. 
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If the file name, suffix/ or logical unit number 
contains more valid characters than required* they will be 
automatically flushed from the input stream. Thus» even if a 
ten character file name is specifiedi only the first eight 
characters will be returned in the file name area. 

The follouiing ssamples illustrate how . PFNAM extracts 
the file name or device specification from the input buffer. 
The left column shows a string as it is encountered in the 
input buffer. The double quotation marks delimit the start 
and end of the string. It should be noted that an initial 
terminator begins each string. The right column shows the 
extracted information as it would appear in the standard file 
name area. The dashes indicate unchanged parts of the 

standard file name avsa (those areas where the default values 
would be found). 

Input string Extracted file name 



H 


FILEi " 


-FILE 




U 


FILEl: 0, " 


OFILEl 


— 


It 


F. SAi " 


-F 


SA 


U 


FILE. RO: 1. " 

/« If 


IFILE 


RQ 




: 0» 


u 




If 


. LX: 1, ■• 


1 


-LX 


11 


FILENAMETOOLONG. AB: 1, " 


IFILENAMEAB 


II 


FILESAB: 1, " 


-FILE 




II 


#LP, " 


-LP 


— 


I* 


#UD: 1, " 


lUD 




If 


FILE*. *: 1, " 


IFILE 


— ~ 


27. 5. ; 


2 Re-enter resident MDOS 


— . MDENT 





The .MDENT function passes control from a calling 
program to the MDOS command interpreter. It is one of the 
few functions which does not return control to the calling 
program. .MDENT can only be used if the resident operating 
system area has not be changed by the calling program (or any 
programs that may have executed prior to it). 

ENTRY PARAMETERS: The diskette in drive zero must not have 

been replaced with another diskette 
since the last time MDOS was 
initialized via the resident debug 
monitor. 

EXIT CONDITIONS: There is no return from this function. 

however/, the following actions are 
performed : 

The SWI and IRQ vectors are configured 
for the MDOS function handler. 
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The user SWI and IRQ vectors maintained 
by MDOS (SWI$UV and IRQ$UV) are reset 
to point to an RTI instruction. The 
user program is no longer residenti 
thus user-defined SWI and IRQ 
interrupts cannot be processed after 
KDOS regains control. 

The end of user memory pointeri END*US» 
is reset. 

The command line buffer is initialized. 

The version/revision numbers of MDOS in 
memory are compared with the 
version/revision numbers in the ID 
sector. The addresses of the system 
overlays avs also compared in this 
fashion. If a discrepancy exists 
between memory and the diskette/ 
EXbug is given control. 



The system lOCBs for 
printer) and the MDOS 
file are configured. ' 



the console/ 
error message 



The input prompt <=) is displayed and a 
new command line accepted from the 
system console. 

The system error status word is cleared 
(Error Type and Error Status Flag) if 
a valid command is interpreted. 



27.5.3 Reload MDOS from diskette 



. BOOT 



m 



The .BOOT function reloads the resident operating syste 
from the diskette in drive zero via the diskette controller 
firmware. This function should be used if the resident 
operating system has been changed by the current program (SWI 
handler must still be intact). This function should also be 
used if the diskette in drive zero has been replaced with 
another MDOS diskette since the last 
initialized via the debug monitor. . BOOT 
functions that does not return control to the calling 
program. 

This function has the same effect as if the ABORT or 
RESTART pushbuttons were depressed on the EXORciser and the 
debug command "EBOO; G" or "MDOS" executed. 



time MDOS 
is one of the 



was 
few 



ENTRY PARAMETERS: 



A valid MDOS diskette must 
drive zero. 



be ready in 
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EXIT CONDITIONS: 



This function doss not return to the 
calling program. A new copy of MDOS 
is brought from the diskette into 
memory. All of the functions 
performed during this type of 
initialization ar^ described in 
section 2. 1 and section 24. 6. 
Control is given to the MDOS command 
interpreter after MDOS has been 
initialized. 



27. 5. 4 Set system error status ujord — . EWORD 



The . EWORD function configures the system error status 
word with a specific error type. This allows a calling 
program to indicate that an error occurred during its 
execution. The system error status uJord can then be tested 
from uiithin a CHAIN procedure (Chapter 6). 



ENTRY PARAMETERS: 



B = The value that is to be placed into 
the Error Type field of the system 
error status uiord. Any value is 
valid. Section 28.4 describes the 
format of the error status word. 



EXIT CONDITIONS: 



A is unchanged. 

B is unchanged. 

X is unchanged. 

CC is indeterminate. 

The lower byte of the system error status 
word contains the value passed in B. 
The Error Status Flag has also been 
set to one. The remainder of the 
error status word is unchanged. 



27.5.5 Allocate user program memory — . ALUSM 



The .ALUSM function adjusts the MDOS pointer ENDUS* to 
reflect the end of the user program avsa. This function 
facilitates the dynamic allocation of variable buffer space 
adjacent to the highest loaded program location so that 
programs can take advantage of the variable amount of 
contiguous memory that may be configured for a given 
installation. 

The user program avsa consists of all contiguous memory 
between the end of the resident operating system and the end 
of contiguous memory. The pointer ENDUS* is automatically 
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adjusted .to reflect the end o-f a loaded program (only if the 
program is loaded directly from the command line or via the 
LOAD command without the "U" or "V" option). Thus, the 
program can obtain information about the remaining amounts of 
memory without having to size memory itself. 



ENTRY PARAMETERS: 



B contains a function code that specifies 
the action to be taken by . ALUSP1. 
The following function codes (and 
their impact the the X register) are 
defined: 



B = O indicates that the X register 
contains the address of the last 
address that is to be made a part of 

vti^ WW. i »..- w - - . f- . -a- — . 

B = 1 indicates that the X register 
contains the number of bytes of 
memory that are to be allocated to 
the end of the current user program. 



B = 2 indicates that all of the remaining 
contiguous memory is to be allocated 
to the current user program arsa. 



contains 
above. 



the parameters as described. 



EXIT CONDITIONS: 



A is unchanged. 

B contains the 
following 
defined: 



return 
return 



status, 
statuses 



The 

avs 



B = indicates that no 
(normal return). 



errors occurred 



B = 1 indicates that the allocation 
request would have caused ENDUS$ to 
be greater than ENDSY*. The user 
program area cannot extend beyond the 
end of contiguous memory in the 
system. 

2=2 indicates that the allocation 
request would have caused ENDUS* to 
be less than or equal to ENDOS*. The 
allocated memory block must reside 
completely above the address 
contained in ENDOS*. 

X contains an indeterminate value if an 
error occurred (exit value of B not 
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zero) or if the entry value of B was 
zero. 

X contains the old value plus one (value 
before the call to . ALUSM) of ENDUS$ 
if the entry value of B uias one. 
Thus* X points to the starting 
address of the neuily allocated block. 

X contains the number of bytes allocated 
if the entry value of B was two. 

Z = 1 and C = if no errors occurred <B 
= 05. The remainder of CC is 

•i n H g+ 3T*«» 2 na t S . 

Z = and C = 1 if an error occurred (B 
not zero). The remainder of CC is 
indeterminate. 

The MDOS variable ENDUS* is unchanged if 
an error occurred. Otherwisej ENDUS* 
will contain the following: if the 
entry value of B ujas zero* ENDUS* 
will contain the entry value of the X 
register; if the entry value of B was 
one. ENDUS* will have been 
incremented by the entry value of the 
X register; and if the entry value of 
B was two. ENDUS* will contain the 
value of ENDSY*. 
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This chapter contains a summary and an explanation of 
all of the standard error messages that can be displayed 
during the operation of MDOS. Standard error messages 
include those displayed by the diskette controller firmware 
during initial i zationi the PROM I/O messages that can be 
displayed when any fatal diskette error is detected by an 
MDOS command or overlay^ and the standard error messages 
displayed by the commands themselves. The standard command 
error messages are recognizable by the fact that a pair of 
asterisks followed by two-digit reference number is displayed 
before the actual message. Explanations of messages without 
the two-digit number should be looked for in the detailed 
command descriptions in chapters 3-23. 

28. 1 Diskette Controller Errors 



The diskette controller errors can be displayed in two 
forms depending on the phase MDOS is in. During the 
initialization phase> the error messages from the controller 
take on the form of the letter "E" followed by a, decimal 
digit 0-9. Control is given to the debug monitor after the 
message is displayed. Aftpr MDOS has been • properly 
initialized/ the diskette controller errors are identified by 
the text "PROM I/O ERROR". Control is returned to the MDOS 
command interpreter. 

28. 1. 1 Errors during initialization 



If for some reason the drive electronics ars not 
properly initialized) or if the diskette in drive zero cannot 
be read properly to load the Bootblock or the resident 
operating systemi then a two— character error message will be 
displayed and control returned to the debug monitor. The 
function resulting in the error has been tried five times. 
After the fifth failure* the error message is displayed. 

Message Probable Cause 



El A cyclical redundancy check (CRC) 

error was detected while reading the 
resident op-erating system into 
memory. 
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E2 



The diskette has the write protection 
tab punched out. During the 
initialization process^ certain 
information is written onto the 
d iskette. 



The diskette is not damaged and can 
still be used for a system diskettei 
houiever. the writs protection tab 
must first be covered uiith a piece of 
opaque tape to ailoui writing on the 
d iskette. 



diskette 



Th a rt nnT» i s 

is not get 



open or the 
turning at the proper speed. If the 
diskette has been inserted into the 
drive with the wrong orientation^ the 
"not ready" error will be also 
generated. This error will also 
occur if a double-sided diskette is 
placed into a single— sided diskette 
drive. 



Closing the doori waiting a little 
bit longer before entering the 
"EBOOjG" or "MDQS" command/ or 
turning the diskette around so it is 
properly oriented should eliminate 
this error. 



E4 



E5 



A deleted data mark was detected 
while reading the resident operating 
system into memory. 

A timeout interrupt occurred. This 
indicates that a diskette controller 
command was not completed within the 
allotted time. This error is also 
produced if a non-maskable interrupt 
(such as depressing the ABORT 
pushbutton on the EXORciser's front 
panel) is generated during a diskette 
operation. 
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E6 The diskette controller has been 

presented with a cylinder-sector 
address that is invalid. This error 
occurs when the sum of STRSCT and 
NUMSCT (see Appendix D) is larger 
than the total number of sectors on 
the diskette. 

This error indicates some type of a 
hardware problem. For example/ the 
error can be caused by missing or 
overlapping memoryj bad memory. or 
pending IRQs that cannot be serviced. 

E7 A seek error occurred mhile trying to 

read the resident operating system 
into memory. 

Like E6 errorsi this one indicates 
some type of a hardujare problem. 

ES A data mark error luas detected while 

trying to read the resident operating 
system into memory. 

E9 A CRC error was faund tuhile reading 

the address mark that identifies 
' sector locations on the diskette. 

The diskette controller errors El; E4, EB. and E9 
indicate that the diskette cannot be used to load the 
operating system; however/ a new operating system can be 
generated on that diskette/ making it useful again. The 
DOSGEN (Chapter 10) and /or FORMAT (Chapter 15) commands 
should be consulted for generating a new diskette. Depending 
on the extent of the errors, the diskette may be used in 
drive one to recover any files that may be on it (see section 
2.8.9). 

The diskette controller error E5 can occur for a variety 
of reasons. The most common reason, and the most fatal, is 
the destruction of the addressing information on the 
diskette. If the addressing information has been destroyed 
(verified by using the DUMP command to examine areas of the 
diskette). the FORMAT command may be used to rewrite the 
addressing; however/ information on the damaged diskette 
cannot be recovered. Occasionally, after a system has just 
been unpacked, the read/write head may have been positioned 
past its normal restore point on cylinder zero. In this 
case, trying the event which caused the error three or more 
times may position the head to the proper place. If this 
fails, the head will have to be manually repositioned past 
cylinder zero; however, this problem rarely occurs. The E5 
errors can also occur if a user-written program accesses 
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drives 1-3 suithout using one o-P the system functions and 
without first restoring the read/write head on that drive. 

Even after the resident operating system has been 
successfully read into memoryj certain errors can occur in 
the subsequent initialisation procedure. During 
initialization the resident operating system cannot access 
the error message processor since it has not been 
initialized. Messages similar in format to those generated 
by the diskette controller are displayed to indicate such 
errors. They differ from the diskette controller errors in 
that the second character of the two-character message is a 
non-numeric character. The follotuing errors can occur during 

has been read into memory. 

Message Probable cause 

E? This error indicates that the RIB of 
the resident operating system file 
MDOS. SY is in error. The operating 
system cannot be loaded. 

The diskette probably is not an MDOS 
system diskette^ or the system files 
have been moved from their original 
places. The REPAIR command (Chapter 
22) can be used to identify which 
files ars missing or if their places 
have been changed. 

EM This error indicates that there was 
insufficient memory to accommodate 
the resident portion of the operating 
system. 

The memory requirements described in 
section 1. 1 should be reviewed. If 
the minimum requirements are 
satisfied) then the existing memory 
should be carefully examined for bad 
locations. 
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EI The version and revision of MDQS 
already loaded into fijejaory is not the 
same as that on diskette. This error 
usually occurs as the result of 
switching diskettes in drive zero 
uiithout following the initialization 
procedure outlined in section 2. 1. 
This error can also occur is the ID 
sector has been damaged. 

The error can be avoided if the 
initialization procedure is followed 
correctly every time a new system 
diskette is inserted into drive zero. 

ER The addresses of the RIBs of the riDOS 
overlays ars not the same as those at 
the time of the last initialization. 
This error may occur for the same 
reasons as the "EI" error. 

EU An input/output system function 
returned an error during the 
initialization. Errors of this sort 
indicate a possible memory problem or 
the opening of the door to drive zero 
while the initialization is taking 
place. 

EV One of the system files is missing or 
cannot be loaded into memory. If a 
system file is missing, the diskette 
has been improperly generated or the 
file was intentionally deleted. If a 
file cannot be loaded* then the 
diskette should be regenerated. The 
diskette may be used in drive one to 
save any files that may be on it 
(section 2.8.9). This error may also 
occur if the door to drive zero is 
opened while initialization is in 
progress. 

28.1.2 Errors after initialization 



If a diskette controller error is detected after MDQS 
has been initialized, then an error message of the following 
format will be displayed. 

**PROM I/O ERROR — STATUS=nn AT h DRIVE i-PSN j 

This message indicates that an unrecoverable error occurred 
while trying to access the diskette. The error status "nn" 
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is a value returned by the diskette controller. The errors 
are of the same type that cause the initialization process to 
give control to EXbug; houjever, instead of beginning uiith the 
letter "E", the status (nn) begins with the digit "3". The 
second digit of the status corresponds directly to the 
diskette controller error number discussed in the previous 
section. The "E" has been replaced by the "3". Thus* status 

31 is the same as £1 

32 is the same as E2 



39 is the same as £9. 

A mefliory address (only meaningful for system diagnostics) is 
substituted for the letter "h"; the logical unit number is 
substituted for the letter "i"; and the physical sector 
number <PSN) at u/hich the error occurred is substituted for 
the letter "j". 

For errors that are retryable (status 31* 34i 38. and 
39)i the following actions have been taken in an attempt to 
bypass the error. Firsts the ROM firmware tried to re-access 
the sector five times. The head u/as then positioned a 
maximum of five cylinders outward from the sector in error, 
repositioned back over the sector, and another five accesses 
attempted. Lastly, the head was positioned a maximum of five 
cylinders inward from the sector in error, repositioned back 
over the sector, and another five accesses attempted. 

Occassional ly. if the diskette in drive zero was changed 
without properly reinitializing the system. or if an MDOS 
system file is moved, renamed, or deleted from the directory, 
the error messages EI. ER. EU. or EV can be displayed and 
control given to the debug monitor. These error messages are 
explained in the previous section. 

28. 2 Standard Command Errors 



The following list contains all of the standard error 
messages than can be displayed by the MDOS commands. They 
are listed in order of their two-digit reference number for 
easy location. This number is not to be confused with the 
error message index number that is loaded into the B 
accumulator when the system error message function (.P1DERR. 
section 27. 4) is accessed. 

In some cases. the error message applies also to 
usei — written programs using the device independent I/O 
functions. Then, the error condition returned in the IDCB 
entry lOCSTA (section 25.3.1.20) will contain a value, which 
when decoded by the . MDERR function. would result in the 
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standard error message being displayed. 

The first error message is standard* but is only 
displayed by the MDOS command interpreter; not by a command. 
It has no number identifying it. The second error message is 
only displayed if the MDOS error message function is called 
with an invalid error message index numberj or if the system 
error message file cannot be accessed u/ithout error. 

WHAT? 

This message indicates that the first file name 
specification entered on the command line was not 
the name of a file in the diskette's directory. 
Most often this error occurs as the result of a 



Some commands; such 
this message to 
command. 



as DUMP and PATCH; display 
indicate an unrecognizable 



** INVALID MESSAGE mm AT nnnn 



This message is displayed by the . MDERR system 
function if it is called u/ith an index number for 
ujhich no valid- error message exists; or if the 
MDOS error message file cannot be accessed on the 
diskette without an error. The number "ram" shows 
the index number of the error message that the 
.MDERR function was trying to display. The 
number "nnnn" shows the address of the call to 
the . MDERR function. 



** 01 COMMAND SYNTAX ERROR 



The syntax of the command line parameters as seen 
by the command could not be interpreted. Most 
often this message refers to undefined characters 
appearing in the <roptiQns> field of the command 
line. 

If this message is displayed during the execution 
phase of the CHAIN command; it may mean that an 
execution operator was encountered that had an 
illegal operand field. 



** 02 NAME REQUIRED 



One or more of the file names required by the 
command as parameters was omitted from the 
command line. 
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** 03 <name> DOES NOT EXIST 

The displayed file name was not found in the 
diskette's directory. The file must exist prior 
to using the command. The <name> is displayed to 
shoui which file name of the multiple naaiss 
specified as parameters caused the error. 

** 04 FILE NAME NOT FOUND 

The file name entered on the command line as a 
parameter does not exist in the diskette's 
directory. The file must exist prior to using 
the command. No file name is displayed since 
only one parameter is required by the command. 

This error can also occur during the FDR 
processing of the .OPEN function uihen a file is 
being opened in the input or update modes. 

** 05 <name> DUPLICATE FILE NAME 

The displayed file name already exists in the 
diskette's directory. The file must not exist 
prior to using the command. The <name> < is 
displayed to show which file name of the multiple 
names specified as parameters caused the error. 

»* 06 DUPLICATE FILE NAME 

The file name entered on the command line as a 
parameter already exists in the diskette's 
directory. The file must not exist prior to 
using the command. No file name is displayed 
since only one parameter is required by the 
command. 

This error can also occur during the FDR 
processing of the .OPEN function when a diskette 
file is being opened in the output mode. 

»* 07 OPTION CONFLICT 

The specified options were not valid for the type 
of function that was to be performed by the 
command. Several of the options are mutually 
exclusive and cannot be specified at the same 
time. The specific command descriptions should 
be consulted for the restrictions concerning the 
various options. 



J 
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** 08 CHAIN ABORTED BY BREAK KEY 

This message is displayed by the CHAIN command to 
indicate that the operator depressed the break 
key during the execution phase, causing it to be 
aborted. 

** 09 CHAIN ABORTED BY SYSTEM ERROR STATUS WORD 

The last program invoked from the CHAIN process 
set an error status into the system error status 
word which mas not masked by a SET operator. If 
no SET operators are used in a CHAIN file* any 
error status uiord change will causa the CHAIN 
process to be aborted. 

** 10 FILE IS DELETE PROTECTED 

An attempt was made to delete a file which had 
the delete protection bit set in its directory 
entry. The file is not deleted. 

** 11 DEVICE NOT READY 

Most frequently this error indicates that a 
command is trying to output to the printer uhile 
the printer is not ready or out of paper; 
however, the message can apply to any of the 
supported devices whether being used for input or 
output. 

** 12 INVALID TYPE OF OBJECT FILE 

Most frequently this message indicates that an 
attempt was made to load a program into memory 
from a file which does not have the memory— image 
attribute. 

This message can also indicate that the RIB of a 
memory-image file has been damaged (LOAD command. 
Chapter 18). 
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** 13 INVALID LOAD ADDRESS J 

This message indicates that an attempt was mad© 
to load a program into memory which* depending on 
the method of loading: 1) loads outside of the 
range of contiguous memory established at 
initialization; 2) loads over the resident 
operating system; 3) loads below hexadecimal 
location S20; or 4) loads beyond location *FFFF. 
The latter case implies that the file's RIB may 
be damaged. If this is the suspected cause. the 
REPAIR command (Chapter 22) should be used to 
correct the error. Programs which load into the 
highest memory address ($FFFF) which do not have 
a starting load address that is a multiple af 
eight* can also cause this error. 

** 14 INVALID FILE TYPE 

The file name entered on the command line as a 
parameter has the wrong file format (the numeric 
portion of a displayed directory entry's 
attribute field) for the intended operation. No 
file name is displayed since only one parameter 
is required by the command. 

This error can also occur if a binary record 
transfer is being requested to a device that does 
not support binary transfers; if a non-record 
format (e.g.* memory-image format) is specified 
when opening a non-diskette device; or if a 
non-ASCII record format is specified when using 
the non— file format mode. 

■** 15 <name> HAS INVALID FILE TYPE 

The displayed file name has the wrong file format 
(the numeric portion of a displayed directory 
entry's attribute field) for the intended 
operation. The <naffle> is displayed to show which 
file name of the multiple names specified as 
parameters caused the error. 

The MERGE command (Chapter 19) can display this 
message if a memory-image file has an invalid 
RIB. The REPAIR command (Chapter 22) should be 
used to correct the error. 

*» 16 CONFLICTING FILE TYPES 

A command was expecting files of the same format. 

The files specified have different file formats ^ 

and/or attributes. 
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** 17 INVALID DATA TRANSFER TYPE 



Ar. attempt uias made to read from an output device 
or file* to write to an input device or file, to 
perform record I/O with the logical sector mods 
set, to perform logical sector I/O with the 
record mode set, to open a non-input/output 
device in the update mode, or to open a 
non— diskette device in the update mode. 



** IS DEVICE ALREADY RESERVED 



Bit 
one 



"R" of the lOCLUN byte in an IOCS was set 
when the .RESRV system function Was called. 



to 



*« IV utvi^c. 



Bit "R" of the lOCLUN byte in an IOCS was set to 
zero when the .OPEN or . RELES system functions 
were called. 



*» 20 INVALID OPEN /CLOSED FLAG 



Bit "0" of the lOCDTT byte in an IDCB was set to 
one when the .CLOSE. . GETRC. . GETLS. . PUTRC, 
. PUTLS, . REWNDi or . RELES system function was 
called, or bit "O" of the lOCDTT byte was set to 
zero when the .OPEN system function was called. 



»* 21 END OF FILE 



An end-of-file record was read from a- 
non-diskette device or an attempt was made to 
read beyond the logical end-of-file in a diskette 
file. Attempting to read from a diskette file 
after the end-of-file error has occurred will 
result in the same error. Reading from a device 
after the end-of-file error occurred may or may 
not result in the same error, depending on what 
caused the initial end-of-file condition. 
Reading a record from a diskette file which 
contains no carriage returns will result in this 
error. 



** 22 BUFFER OVERFLOW 



An attempt was made to read a record which was 
larger than the data buffer provided for the 
record. The overflow of the record is truncated. 

During the CHAIN command's execution phase, a 
supplied "input response exceeded the maximum 
number of characters acceptable for the input 
request. 



Page 29-11 



ERROR MESSAGES 28. 2 — Standard Command Errors 

*» 23 CHECKSUM ERROR 

A binary record or an ASCII-converted-binary 
record was read whose calculated checksum did not 
agree uiith the checksum byte contained in the 
record. 

This error can also occur during the FDR 

processing of the .OPEN function. If the file 

format mode is specified, and the device is read 

in search of an FDR, any record that begins with 

the FDR header character but which is not an FDR 

(e. g. ; created in non— f ile format mode) uiill 
cause this error. 

** 24 LOGICAL SECTOR NUMBER OUT OF RANGE 

An attempt mas made to read a logical sector 
beyond the physical end of the file. The 
physical end of the file is the highest numbered 
logical sector allocated to the file. This error 
can also be caused if the lOCSDW and IDCSLS 
entries of the IOCS are changed by the calling 
program after the file has been opened. 

»* 25 INVALID FILE NAME 

A file name was specified that contained the 

family indicator (*), ' began with a device name 

indicator (#), or began with a non-alphabetic 
character. 

The NAME command (Chapter 20) limits the use of 
the family indicator. Failure to do so may 
result in this error. 

*■* 26 FILE IS WRITE PROTECTED 

An attempt was made to write into a file which 
has the write protection attribute set in its 
directory entry. 

This error can also be caused by attempting to 
open a diskette file in the update mode which 
already has the write protection bit set. 

** 27 <name> IS WRITE PROTECTED 

The file <name> had the write protection 
attribute set in its directory entry when an 
attemot was made to write to the file. 
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** 28 DEVICE NAME NOT FOUND 

A device name was specified uhich is not defined 
as an MDOS-supported device. This usually occurs 
if the device name is mistyped. The valid device 
names for the I/O functions are CH, CR, CP, DK, 
and LP. If a logical unit number is specified 
for a proper device that is greater than the 
number of units present for that device, then 
this error may also occurr (e.g.. specifying 
units greater than 3 for for diskette drives or 
units greater than for other devices). 

The COPY command (Chapter 7) will also accept the 
device names HR and UD. 

** 29 INVALID LOGICAL UNIT NUMBER 

A logical unit number was specified that is 
invalid. If the device is a diskette, the valid 
logical unit numbers are zero through three. For 
non— diskette supported, devices only logical- unit 
numbers of zero are allowed. 

** 30 INVALID EXECUTION ADDRESS 

The starting execution address of a program in a 
memory— image file is less than the lowest address 
or greater than the highest address loaded into 
by the program. This indicates a RIB error. The 
REPAIR command (Chapter 22) should be used to 
correct the error. 

The EXBIN command (Chapter 14) uses this message 

to refer to an illegal specification of an 
execution address in the options field (i.e., a 
non— hexadec imal digit). 

** 31 INVALID DEVICE 

A valid device name was used in an illegal 
context. For example, the device LP cannot be 
used in the context of an input device. The name 
DK cannot be used on the command line of any of 
the MDOS commands. The COPY command does not 
allow the CN device to be used as an input 
spec if ication. 

This message can also indicate an attempt to 
perform logical sector I/O on a non-diskette 
device. or an attempt to perform non-file format 
I/O on a device that does not support the 
non-file format mode. 
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If a non-standard device is being interfaced to 
the system using the device independent I/O 
functions/ this error can indicate that the 
lOCQDW entry of an IOCS <address of CDB) is zeroi 
or that the address of the software driver 
(CDBSDA of CDB) is zero. 

♦* 32 INVALID RIB 

An attempt luas made to open a file (usually a 
memory-image file) that has an invalid RIB. The 
criteria for a valid RIB are explained in detail 
section 24. 2. The REPAIR command (Chapter 22) 
should be used to correct the error. 

»* 33 TOO MANY SOURCE FILES 

More file names mere specified on the command 

line than could be accommodated by a command 

which can accept multiple file names as 
parameters. 

** 34 INVALID START/END SPECIFICATIONS 

The start and end specifications entered on the 
command line for the LIST command did not start ; 
with the letters "S" or "L". This error can 
occur if the starting specification starts with 
"S" and the ending specification starts with "L"/ 
or vice versa. If the end specification has a 
value less than the value of the start 
specification) then this error u/ill also occur. 

** 35 INVALID PAGE FORMAT 

A non-standard page format was specified which 

had an invalid number of columns/line or 

lines/page. The specific command description 

should be consulted for the limits of these 
specifications. 

»* 36 FILE EXHAUSTED BEFORE LINE FOUND 

A start specification entered on the command line 
of the LIST command (Chapter 17) specified a 
physical line number whose value was larger than 
the total number of lines in the file. The same 
type of error can be caused by a line number 
specification in a BLQKEDIT command file (Chapter 
5). 
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** 37 END OF MEDIA 



A File Descriptor Record u/as being searched for 

on a non-diskette device or a record output 

transfer was taking place on a non-diskette 

device when the device ran out of medium (e.g.* 
end of cassette or paper tape). 



** 38 INVALID LINE NUMBER OR RANGE 

A line number was encountered in the BLOKEDIT 
command file (Chapter 5) which did not begin with 
an asterisk/ a double quote, a decimal digit 
(0-9). or an alphabetic character (A-Z), and the 
line was not a quoted line. If the command line 
started with a digit.- then the physical line 
number had a value outside of the range 1-65535* 
or the starting number of a line number range was 
greater than the ending line number of the range. 

** 39 LINE NUMBER ENTERED BEFORE SOURCE FILE 

A line number was encountered in the BLOKEDIT 
command file (Chapter 5) before an input file was 
opened. 

** 40 DIRECTORY SPACE FULL 

An attempt was made to add a new entry to the 
directory when no empty directory entry could be 
found (first byte equal to zero or to SFF). The 
directory can accommodate 160 (decimal) entries. 
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** 41 INSUFFICIENT DISK SPACE 



While trying to writs to 
an allocation request fo 
ujith insufficient room 
requirements. This can 
extend a file whose attr 
space allocation. In thi 
space ma^ be available 
actually required* the sp 
the already allocated spa 
occur itfhen trying to 
contiguous allocation o 

than the requested siz 
occur if the diskette is 
file is being created or 
attempting to expand by 
File reorganization 
consolidate fragmented sp 
the size of the available 



a file or close a file, 
r more space returned 
to accommodate the space 

occur u>hen trying to 
ibutes demand contiguous 
s ca3e> even though more 

on the diskette than is 
ace is not adjacent to 
ce. This error can also 
create a file with 
n a diskette uiheTS the 
uDus block is smaller 
e. This error can also 
1007. full ujhen a new 
when an existing file is 
even a single sector. 

(section 3. 3) will 
aca> possibly increasing 

contiguous space. 



*-* 42 SEGMENT DESCRIPTOR SPACE FULL 

During an allocation request for additional 
space* the file's Retrieval Information Block, was 
found to have the- maximum number of Segment 
Descriptors already in use. File reorganization 
(section 3.3) will consolidate segment 
descriptors. 

** 43 INVALID DIRECTORY ENTRY NO. AT nnnn 



An IOCS (or DFT) contained a value in its IDCDEN 
(or DEN) entry which was outside of the allowable 
limits of valid directory entry numbers. The 
address "nnnn" gives the location of the call to 
the error message function. 



** 44 CANNOT DEALLOCATE ALL SPACE. DIRECTORY ENTRY EXISTS 
nnnn 



AT 



This message indicates a hardware or system 
software malfunction if generated by one of the 
MDOS commands. A directory entry must be flagged 
as deleted prior to having the file's space 
deallocated. The address "nnnn" gives the 
location of the call to the error message 
function. 
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** 45 RECORD LENGTH TOO LARGE 



An attempt uias made to write a binarij record or 
an ASCII-converted— b inary record which had more 
than 254 (decimal) data bytes. 



*« 46 INTERNAL SYSTEM ERROR AT nnnn 



This message indicates a hardware or system 
software malfunction. Careful notes should be 
made regarding the events leading up to this 
error. Motorola Microsystems should be notified. 
The address "nnnn" gives the location of the call 
to the error message function. 



** 47 INVALID SCALL 



This message indicates that a program attempted 
to access the MOOS SWI (system function) handler 
with a function byte following the SWI 
instruction that is not defined. If breakpoints 
are patched into memory without using the EXbug 
command "nnnn; V"» this error may occur if the SWI 
vector is still configured for MDOS functions. 

• « 

♦* 48 CHAIN OVERLAY DOES NOT EXIST 

The CHAIN overlay's file name does not exist in 
the directory. The REPAIR command (Chapter 22) 
should be used to check the diskette for other 
errors. 

** 49 CHAIN ABORTED BY ILLEGAL OPERATOR 

An illegal execution operator was encountered in 
the intermediate file during the CHAIN command's 
execution phase. 

** 50 CHAIN ABORTED BY UNDEFINED LABEL 

A JMP execution operator was encountered which 
referenced a label that did not exist in the 
intermediate file (forward direction only) during 
the CHAIN command's execution phase. 

** 51 CHAIN ABORTED BY PREMATURE END OF FILE 

An access to the intermediate file returned an 
end-of-file condition when an input request was 
made by a program that was invoked by the CHAIN 
process. All input that is expected by the 
program must be supplied by the intermediate 
file. 



Page 28-17 



ERROR MESSAGES 



** 52 SECTOR BUFFER SIZE ERROR 



28. 2 — Standard Command Errors 



The sector buffer pointers of an lOCB do not 
describe a sector buffer that is an integral 
nuflsbsr of sectors in size. When a file is 
opened, the lOCSBS and the IDCSBE entries of the 
IOCS must point to the first and last bytes of a 
sector buffer. The following relationship must 
be true: 

IOCSBE-IOCSBS+1 

._-.«__. , ss INTEGRAL NUMBER OF SECTORS 

128 

When using the logical sector I/O functions 
<. GETLS. .PUTLS), the above relationship must be 
true also. In addition, the . PUTLS function 
requires that the sector buffer to be output be 
described by the pointers lOCSBS and lOCSBI 
(instead of lOCSBE). Then, the buffer described 
by lOCSBS and lOCSBI must also be an integral 
number of sectors in size. 



»* 53 INSUFFICIENT MEMORY 

This message indicates that a command could not 
allocate sufficient memory in the user program 
area to complete its task. The minimum memory 
requirements described in section 1. 1 is 
sufficient for all MDOS commands. Thus. this 
message indicates a problem with the existing 
memory/ or tampering taith the memory map. The 
same is true for the MDOS-Sup ported software 
products that display this messagei however/ the 
memory requirements for the particular product 
that displayed the error message should be 
reviewed (Appendix H). rather than those for the 
standard MDOS command.s in section 1. 1. 

The ROLLOUT command (Chapter 23) may display this 
message to indicate that the address given as the 
destination of the position-independent routine 
is outside of a valid addressing range (missing 
memory ). 

28. 3 Input/Ouput Function Errors 

The MDOS system functions that perform I/O through an 
IOCS parameter table uill return an error status in the 
lOCSTA entry of the IOCS. These error conditions can be 
decoded and displayed as messages by the MDOS error message 
function by loading the B accumulator uiith a zero and leaving 
the lOCB's address in the X register. The errors are part of 
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the standard error messages explained above. This section 
contains the system symbols from the MDOS equate file that 
are used to reference the I/O errors. The folloujing table 
shows the value of the lOCSTA byte, the system symbol equated 
to that value from the MDOS equate file* and the error 
message. 

Standard Error Message Displayed 
by . MDERR (B=0, X=IOCB address) 



lOCSTA 


System 


Value 


Symbol 


00 


I^NQER 


01 


I$NODV 


02 


I*RESV 


03 


I^NORV 


04 


I«NRDY 


05 


I*IVDV 


06 


I*DUPE 


07 


I5N0NM 


08 


I$CLOS 


09 


I*EOF 


OA 


I*FTYP 


OB 


I*DTYP 


OC 


I«EDM 


OD 


I$BUFO 


OE 


I*Ci<SM 


OF 


I*WRIT 


10 


I«DF1T 


11 


I*RANG 


12 


I*FSPC 


13 


I«DSPC 


14 


I*SSPC 


15 


I«IDEN 


16 


I*RIB 


17 


I«DEAL 


18 


I*RECL 


19 


I*SECB 



Normal 

** 28 

*■* IS 

** 19 

** 11 

** 31 

** 06 

•it* 04 

** 20 

** 21 

** 14 

*» 17 

** 37 

♦* 22 

** 23 

** 26 

** 10 

** 24 

«•* 41 

*» 40 

** 42 

»* 43 

** 32 

«•» 44 



** 45 
** 52 



return, no error 
DEVICE NAME NOT FOUND 
DEVICE ALREADY RESERVED 
DEVICE NOT RESERVED 
DEVICE NOT READY 
INVALID DEVICE 
DUPLICATE FILE NAME 
FILE NAME NOT FOUND 
INVALID OPEN/CLOSED FLAG 
END OF FILE 
INVALID FILE TYPE 
INVALID DATA TRANSFER TYPE 
END OF MEDIA 
BUFFER OVERFLOW 
CHECKSUM ERROR 
FILE IS WRITE PROTECTED 
FILE IS DELETE PROTECTED 
LOGICAL SECTOR NUMBER OUT OF 

RANGE 
INSUFFICIENT DISK SPACE 
DIRECTORY SPACE FULL 
SEGMENT DESCRIPTOR SPACE FULL 
INVALID DIRECTORY ENTRY NO. AT 

nnnn 
INVALID RIB 
CANNOT DEALLOCATE ALL SPACE/ 

DIRECTORY ENTRY EXISTS AT 

nnnn 
RECORD LENGTH TOO LARGE 
SECTOR BUFFER SIZE ERROR 



23. 4 System Error Status Word 



Within the operating system's resident variables is a 
two-byte error status word. Each MDOS command will set or 
clear a bit uiithin this status word to indicate the status of 
the command's completion. The error status word has the 
following format: 
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F E 



S 



Ettot 



Error 
Hask 



Error Type 



Bits 0-7 describe 
error 

Error Mask Flag 
Bit 3 <S-A unused) 

Error Status Flag 
Bit F (C-E unused) 



Normallyj after the completion of each command all bits of 
the Error Status and the Error Type are cleared <= 0). If an 
error occurred during the command, the Error Status Flag <bit 
F) mill be set by the command. In addition/ an Error Type 
uiill be set into the louer half of the status uord (bits 
0-7). The Error Type is used to indicate which error tuas 
detected by the command. 

Usually* the CHAIN process mill abort anytime the Error 
Status Flag is set by one of the commands invoked from the 
intermediate file; however/ the Error Mask can be used to 
inhibit CHAIN process aborting due to command errors. The 
Error Mask Flag (bit B) uiill inhibit CHAIN process aborting 
if it is set to one. The process of setting the Error Mask 
is described in section 6. 4. 

28. 5 Commands Affecting Error Status Word 



All MDOS commands that are intended to be invoked by the 
CHAIN process have been programmed to configure error types 
into the system error status word. These error types ars 
summarized here to facilitate the user who is taking 
advantage of the TST execution operator during the CHAIN 
process. 



All 
display i 
that cor 
namelyi 

MDERR f 
error me 
error me 
function 
Error Ty 
than or 



MDOS command 
ng the commo 
respond to th 

the error 
unction (not 
ssage referen 
s sages that a 
These erro 
pe field of t 
equal to 1 



s use the system function . MDERR for 
n error messages. ThuSi the error types 
ese messages uill aluays be the same: 
message's index number used to call the 
the same as the displayed/ tuio— digit/ 
ce number); however/ commands have other 
re displayed independently of the .MDERR 
rs uiill cause a value to be set into the 
he error status word that is greater 
28 (*80). It is these values, which are 
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unique to each command, that aTe summarized here. The 
foilouing table contains the name of the MDOS command or 
system function that sets the Error Type/ the value of the 



Error Type in hexadecimal/ 
that caused the error. If 
capital letters/ it is an 
is in upper ./iouier case 
condition. 



and the error message or condition 

the text in the table is in 

actual error message. If the text 

letters, then it is an error 





Error 


MDOS Function 


Type 


MDOS Command 


$80 


Interpreter 




. MDERR 


*FF 


BACKUP 


«ao 



$81 
$82 
$83 

$84 
$85 
$86 
$87 



Error Message or Condition 



WHAT? 



*«■ INVALID MESSAGE mm AT nnnn 

SOURCE FILE COPY ERROR 
OBJECT FILE CREATION COPY ERROR 
CANNOT DELETE DUPLICATE NAME 
INVALID TO COPY/VERIFY FROM 
DOUBLE TO SINGLE SIDED 
DIRECTORY READ/WRITE ERROR 
SYSTEM SECTOR COPY ERROR 
SYNTAX ERROR 
Sector verify error 



BINEX 
BLOKEDIT 
CHAIN 
COPY 

DEL 



$80 Response other than 

overwrite question 
$81 Verify error 

$80 <name> DOES NOT EXIST 
$81 <name> IS PROTECTED 



to 



DIR 



$80 NO DIRECTORY ENTRY FOUND 
$81 NO TERMINATOR FOUND IN 

R. I. B. 
$82 »N0 SDWS* 



FILE'S 



DOSGEN 



$80 INVALID SECTOR NUMBER 
$81 SECTOR xxxx LOCKED OUT 



DUMP 



$80 SYNTAX ERROR 

$81 MODE ERROR 

$82 BOUNDARY ERROR 

$83 INVALID SECTOR ADDRESS 

$84 WHAT? 
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ECHO 
EMCQPY 

EXBIN 



FORMAT 

FREE 

LIST 

LOAD 

NAME 

MERGE 



$80 
$81 
$82 

$83 



$80 



PATCH 






$80 
$81 
$82 
$83 
$84 
$85 


REPAIR 






- 


ROLLOUT 






- 


The fallouji: 


ng 


MDOS-supp 


publication) 


ch 


ange 


the E 
Error 


Command 






Type 



SSURCE FILE ^4GT ASCII 
RECORD FORMAT ERROR 
START ADDRESS OUT OF RANGE 
CHECKSUM ERROR 



Response other than 
overwrite q,uestion 

INITIALIZATION ERROR 
WHAT? 

SYNTAX ERROR 
ILLEGAL OP CODE 
ILLEGAL OPERAND 
ILLEGAL ADDRESS 



14 Y* 



to 



ASM 



ASM 1000 



ASM3870 



lands (available at time of 



Error Message or Condition 



The error message number of the 

last encountered error uiill 
appear in the Error Type. 

The error message number of the 

last encountered error will 
appear in the Error Type. 

The error message number of the 

last encountered error uill 
aooear in the Error Type. 



BASIC 
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FORMIOOO 

FORT 

MASM 

MPL 

RASM 

RASM09 

RLOAD 



*80 Any compiler-detected error 



$80 Any compiler-detected error 

- The error message number of the 
last encountered error u;ill 
appear in the Error Type. 

- The error message number of the 
last encountered error will 
appear in the Error Type. 

$80 Illegal Commmand 

$81 Illegal command syntax 

$83 User assignment error 

$84 Undefined intermediate file 

$85 Phasing error 

$86 Section overflow 

$87 Undefined object file 

$88 Illegal object record 

$89 Local symbol table overflow 

$8D Undefined symbol 

$8E Multiply defined symbol 

$8F Illegal addressing mode • 

$90 Global symbol table overflow 
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Cy linder-Sector/Physical Sector Conversion Table 



The folloujing tables give the physical sector numbers 
for the first sector of every cylinder. The first table is 
for single— sided diskettes. All sectors are recorded on 
surface zero» or the top surfacsi of a single— sided diskette. 

The second table is for double— sided diskettes. The 
physical sector numbers are given for the first sector of a 
cylinder on each surface. Surface zero is the top surface 
and surface one is the bottom surface. 

The following notation is used in the table headings: 

NOTATION MEANING 



CYLINDER The numbers in these columns are the 
cylinder numbers on the diskette. 
They are given in both decimal and 
hexadec imal. 



PSN 



The numbers in these columns are the 
hexadecimal physical sector numbers 
of the first sector on a cylinder 
surface. 



DEC 




HEX 




SFC 





SFC 


1 



Numbers in these columns sve decimal. 

Numbers in these columns avs 
hexadecimal. 

The top surface^ surface zero. 

The bottom surface^ surface one. 
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SINGLE-SIDED DISKETTES 
CYLINDER PSN CYLINDER PSN 



00 


00 


000 


01 


01 


OlA 


02 


02 


034 


03 


03 


04E 


04 


04 


068 


05 


05 


082 


06 


06 


09C 


07 


07 


0B6 


08 


08 


ODO 


09 


09 


OEA 


10 


OA 


104 


11 


OB 


HE 


12 


OC 


138 


13 


OD 


152 


14 


OE 


16C 


15 


OF 


186 


16 


10 


lAO 


17 


11 


IBA 


IS 


12 


1D4 


19 


13 


IHE 


20 


14 


208 


21 


15 


2-^2 


22 


16 


23C 


23 


17 


256 


24 


18 


270 


25 


19 


23A 


26 


lA 


2A4 


27 


IB 


2BE 


28 


IC 


2D8 


29 


ID 


2F2 


30 


IE 


30C 


31 


IF 


326 


32 


20 


340 


33 


21 


35A 


34 


22 


3/4 


35 


23 


38E 


36 


24 


3A8 


37 


25 


3C2 


38 


26 


3DC 



DEC HEX HEX DEC HEX HEX 



39 


27 


3F6 


40 


28 


410 


41 


29 


42A 


42 


2A 


444 


43 


2B 


45E 


44 


2C 


478 


45 


2D 


492 


46 


2E 


4AC 


47 


2F 


4C6 


48 


30 


4E0 


49 


31 


4FA 


50 


32 


514 


51 


33 


52E 


52 


34 


548 


53 


35 


562 


54 


36 


57C 


55 


37 


596 


56 


38 


5B0 


57 


39 


5CA 


58 


3A 


5E4 


59 


3B 


5FE 


60 


3C 


613 


61 


3D 


632 


62 


3E 


64C 


63 


3F 


666 


64 


40 


6R0 


65 


41 


69A 


66 


42 


6B4 


67 


43 


6CE 


68 


44 


6E8 


69 


45 


702 


70 


46 


71C 


71 


47 


736 


72 


48 


750 


73 


49 


76A 


74 


4A 


784 


75 


4B 


79E 


76 


4C 


7B8 
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Cy 1 inder-Sector/Physicai Sector Conversion Table 



DOUBLE-SIDED DISKETTES 



CYLINDER 




PSN 


DEC 


HEX 


SFC 


SFC : 





000 


OOO 


OlA 


1 


001 


034 


04E 


2 


002 


068 


082 


3 


003 


09C 


OB 6 


4 


004 


ODO 


OEA 


5 


005 


104 


HE 


6 


006 


138 


152 


7 


007 


16C 


136 


8 


008 


lAO 


IBA 


9 


009 


1D4 


lEE 


10 


OOA 


208 


2PP 


11 


OOB 


23C 


256 


12 


OOC 


270 


28A 


13 


OOD 


2A4 


2BE 


14 


OOE 


2D8 


2F2 


15 


OOF 


30C 


326 


16 


010 


340 


35A 


17 


Oil 


374 


38E 


IS 


012 


3A8 


3C2 


19 


013 


3DC 


3F6 


20 


014 


410 


42A 


21 


015 


44-4 


45E 


22 


016 


478 


492 


23 


017 


4AC 


4C6 


24 


018 


4E0 


4FA 


25 


019 


514 


5PF 


26 


OlA 


548 


562 


27 


OIB 


57C 


596 


26 


OIC 


5BO 


5CA 


29 


OlD 


5E4 


5FE 


30 


OlE 


618 


632 


31 


OIF 


64C 


666 


32 


020 


680 


69A 


33 


021 


6B4 


6CE 


34 


022 


6E8 


702 


35 


O'cL'J 


71C 


736 


36 


024 


750 


76A 


37 


025 


784 


79E 


38 


026 


7B8 


7D2 



CYLINDER 


PJ 


3N 


DEC 


HEX 


SFC 


SFC 


39 


027 


7EC 


806 


40 


028 


820 


a3A 


41 


029 


854 


86E 


42 


02A 


888 


8A2 


43 


02B 


SBC 


SD6 


44 


02C 


8F0 


90A 


45 


02D 


924 


V3E 


46 


02E 


953 


972 


47 


02F 


98C 


9A6 


48 


030 


9C0 


9DA 


49 


031 


9F4 


AOE 


50 


032 


A2S 


A42 


51 


033 


A5C 


A76 


52 


034 


A90 


AAA 


53 


035 


AC 4 


ADE 


54 


orwH 


AF8 


B12 


55 


037 


B2C 


B46 


56 


036 


B60 


B7A 


57 


0'J9 


B94 


BAE 


58 


03A 


■ BCS 


BE2 


59 


03B 


BFC 


C16 


60 


03C 


C30 


C4A 


61 


03D 


C64 


C/E 


62 


03E 


C98 


CB2 


63 


03F 


CCC 


CE6 


64 


040 


DOO 


DIA 


65 


041 


D34 


D4E 


66 


042 


D68 


D82 


67 


043 


D9C 


DB6 


68 


044 


DDO 


DEA 


69 


045 


E04 


ElE 


70 


046 


bJS 


E52 


71 


047 


E6C 


E86 


72 


048 


EAO 


EBA 


73 


049 


ED4 


EEF 


74 


04A 


F08 


F22 


75 


04B 


F3C 


F56 


76 


04C 


F70 


FSA 
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BITS 4 TO 6 



B 
I 
T 
S 



T 




APPENDIX 



ASCII Character Set 






NUL 


DLE 


SP 





e 


P 


\ 


P 


1 


SOH 


DCl 


1 


1 


A 


Q 


a 


q 


2 


STX 


DC2 


1) 


2 


B 


R 


b 


r 


3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


4 


EOT 


DC 4 


* 


4 


D 


T 


d 


t 


5 


E.NG 


r4AK 


7. 


5 


E 


•J 


e 


u 


6 


ACK 


SYN 


S( 


6 


F 


V 


f 


V 


7 


BEL 


ETB 


t 


7 


G 


w 


3 


ID 


S 


BS 


CAN 


( 


S 


H 


X 


h 


X 


9 


KT 


EM 


) 


9 


I 


Y 


i 


y 


A 


LF 


SUB 


* 




J 


z 


J 


Z 


B 


VT 


ESC 


+ 


J 


K 


c 


k 


< 


C 


FF 


FS 


J 


< 


L 


\ 


1 


I 
I 


D 


CR 


ss 


- 


= 


M 


3 


m 


y 


E 


SO 


RS 




> 


N 


^^. 


n 


•N# 


F 


SI 


US 


/ 


? 







o 


D 



DEL 
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MDOS Command Syntax Summary 



Chapter Command Line Options 

3* BACKUP CE: <5ource unit>, 3: <de5tination unit>D Li<options>3 

null - Normal copy 
A - Append 
R - Reorganize 

V - Verify 

C - Disk error continue 

D - Deleted data mark continue 

I - ID sector 

L - Line printer 

N - No printing 

S - Sector number only 

U - Unallocated space 

V - Delete duplicate 
Z - Skip duplicate 

4 BIMEX <memory-image f i le>C; <EXbug-loadab le file>3 

5 BLDKEDIT -Ccommand file>»<neui file> 

6 CHAIN <:command file> C; <tag i>C%<value i>%3 ...3 
CHAIN N* 

CHAIN * 

7 COPY <source name>C/ <d estination name>3 Cj<options>3 

B - Automatic verify after copy 

C - Convert binary records 

D=<file>Ci ] - Driver file 

L - Line printer 

M - Test driver via debug monitor 

N - Non-file format 

V - Verify 

U ~ Overwrite 



8* DEL i:<filB>3 C; <options>3 



9» DIR C<file>: Ej<options>: 



S - System files 
Y - Yes. delete 



A - Allocation information 
E - Entire entry 
L - Line printer 
S - System files 
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Chapter Command Line Options 

10 DOSGEN C:<unit>3 Ci<options>3 

T - Write/read surface test 

U — User diskette (minifflum system files] 

11 DUMP t<fila>l 

12 ECHO C;<options>] 

N - Turn echo off 

13 EMCQPY [:<EDOS f i le>3 Ci <MDOS file>3 Cj <options>1 

A — ASCII record format 
C - Contiguous allocation 
D - Delete protection 
E - Entire disk copy 
R - Sinary record format 
S - Selected file copy 

14 EXBIN <EXbug lodadable f i le>Cj </nemary-image file>3 Ci <start addressli 

15 FORMAT C: <unit>] 

16 FREE i:;<unit>J C; <optians>3 

L - Line printer 

17 LIST <ASCII file>C, C<start>:[:i <end>3: C;<options>n 

FCmmmJ. CnnJ - Page format 
H - Input heading 
L - Line printer 
N - Line numbers 

IS LOAD C<memary-image file>l Cj<options>] 

null - Go to EXbug 

null - Load above MDQS 

G - Load and go 

U - EXORciser II User Memory Map 

V - Overlay MDOSi discontiguous memory 

(<string>) - Initialize command buffer 

19 MERGE <file l>C/<file 2>,....<file n>3, <destination file> Ci<options 

W - Over ujr its 
<start address> 

20# NAME <oid name>C/ <neuj name>J C/<options>3 

D - Delete protection 
N - Non-system file 
S - System file 
W - Write protection 
X - No protection 



21 PATCH <memory-image file> 



APPENDIX C MDOS Command Syntax Summary 

Chapter Command Line Options 

22 REPAIR C:<unit>3 

23 ROLLOUT CCmemory-image file>: C;<options>D 

null - Memory above MDOS 
D - Build file from scratch diskette 
U - EXORciser II User Memory Map 
V - Any memory to scratch diskette 

* These commands allow the family indicator in the file 
name specification. 
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Diskette Controller Entry Points 



The floppy diskette controller module firmtuare is used 
to control all of the EXORdisk II/III hardujare functions. 
The entry points to the various functions are described in 
this section. Parameters required by the firnsmare functions 
are stored in RAM in the locations described by the following 
table: 



Name 



Address Definition 



CURDRV «0OO0 



This byte contains the binary logical 
unit number of the drive to be selected 
(zero through three). 



STRSCT SOOOl 



These two bytes contain 
sector number of the first 
used (starting sector). 



the physical 
sector to be 



NUMSCT «0003 



These two bytes contain the number of 
sectors to be used. This number includes 
a partial sector^ if a partial sector 
read is being requested. The sum of 
STRSCT and NUMSCT cannot be greater than 
*7D2 (single-sided diskettes) or $FA4 
(double-sided diskettes). 



LSCTLN $0005 



This byte contains the number of bytes to 
be read from the last sector during a 
read operation. This number should be a 
multiple of eight and cannot be greater 
than 128 (*80). If a number is specified 
that is not a multiple of eight, the next 
larger multiple of eight bytes mill be 
read. 



CURADR *0006 



These two bytes contain the first address 
in memory that is to be used during a 
read or write operation. This location 
is updated after each sector is read or 
written. During write test operations, 
these two bytes contain the address of a 
two-byte data buffer. 



FDSTAT $0008 



This byte contains a status indication of 
the performed function. If an error 
occurred during a diskette operation, the 
carry bit in the condition code register 
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ijiill be set to one upon returning to the 
calling program. In addition! FDSTAT 
will contain a number indicating the 
error type <«31 - *39). The error types 
are explained in Chapter 28. If no error 
occurs) then the carry bit of the 
condition code register will be set to 
zero and FDSTAT will contain the value 
*30. 

SIDES *OOOD This byte contains an indication of the 



type 



of diskette that is in a drive. If 



the sign bit (bit 7) of this location is 

SS't to one dri»«i a «a3i«cw»<» .. — - . — ■- 

accessed, then the diskette is 
single-sided. If the sign bit of this 
location is set to zero after a diskette 
has been accessed, then the diskette is 
double-sided. In earlier versions of the 
diskette controller firmware (EXQRdisk 
II), this location will always have the 
sign bit set to one. 

For ail of the firmware entry points described below, 
the content of the registers is unspecified both upon entry 
and exit from the routine. Each entry point is accessed by 
executing a "jump to subroutine" instruction (JSR). The 
parameters must have been set up in RAM as indicated for each 
specific function. It should be noted that the ROM routines 
for the diskette functions run with the interrupt mask bit 
set to one in the condition code register. The routines also 
use the NMI vector. Both the NMI vector and the interrupt 
mask avs restored before returning to the calling program. 

Name Address Function 



aSLQAD $EBOO This entry point initializes the drive 

electronics and loads the Bootblock and 
MDOS retrieval information block from the 
diskette in drive zero. The Bootblock is 
given control after it has- been loaded 
from the diskette. It, in turn/ causes 
the rest of the operating system to be 
loaded into memory. No parameters are 
required for this entry point. This 
function does not return control to the 
calling program. If an error occurs 
during the Bootblock load process, the 
error number will be displayed on the 
system console and control passed to the 
resident debug monitor. At least *i20 
bytes of memory ave required starting at 
location zero. If less memory exists. 
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the Bootblock program may not be able to 
display an error message indicating that 
there is insufficient memory in the 
system. The SWI vector must be 
configured for the debug monitor before 
this entry point can be used (e.g.. the 
ABORT or RESTART pushbutton on the front 
panel of the EXORciser must have been 
depressed ) . 



FDINIT *EB22 



This entry point initializes the PIA and 
SSDA. No parameters are required by this 
routine and none ars modified by it. 



CHKERR «EB53 



PRNTER *Ea5A 



READSC $EB69 



READPS *Ee6D 



This entry point is used to check for a 
diskette controller error if called 
immediately after returning from another 
ROM entry point. 



The routine will check 



the state of the cbtv^ 
condition code register. 



flag in the 
If the carry 



the CHKERR routine 
to the calling 
flag is set to one 
then the routine 
followed fay the 
two spaces on the 



flag is set to zero. 

will simply return 

program. If the carry 

(an error occurred)/ 

will print an "E" 

contents of FDSTAT and 

system console. Control is given to the 

resident debug monitor after printing the 

error message. CHKERR does not change 

any of the parameters. 

This entry point will print an "E" 
followed by the contents of FDSTAT 
followed by two spaces on the system 
console. PRNTER does not change any of 
the parameters. 



This entry point causes the 
sectors contained in NUMSCT 
with STRSCT from CURDRV to be 
memory starting at the addres 
in CURADR. CURADR is updated 
address that is to be written 
each sector is read. The 
LSCTLN is automatically set t 
so that a complete sector is 
memory when the last sector is 
The parameters CURDRV, STRSCT, 
avs not changed. FDSTAT will 
status of the read operation. 



number of 
beg inning 

read into 
s contained 
to the next 

into after 

parameter 

o 12S ($80) 

reBd into 

processed. 

and NUMSCT 
contain the 



This entry point is similar to READSC 
with the exception that the last sector 
is only partially read according to the 
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RDCRC $ES6F 



contents of LSCTLN. If LSCTLN contains 
128 <«80)j then this entry point is 
identical to READSC. The restrictions 
placed on LSCTLN are described in the 
prtcading table of the parameters. 

This entry point causes the number of 
sectors contained in NUMSCT beginning 
mith STRSCT from CURDRV to be read to 
check their CRCs. The contents of the 
sectors avs not read into memory. The 
only parameter changed is FDSTAT. 



RWTEST $ES72 



This entry point causes the two bytes 
located at the address (and at address + 
1) contained in CURADR to be written into 
alternating bytes of NUMSCT sectors 
beginning uiith STRSCT of CURDRV. After 
NUMSCT sectors are written in this 
fashionj they ars read back to verify 
their CRCs. The only parameter changed 
is FDSTAT. 



RESTOR ?eS75 



This entry point causes the read/write 
head on CURDRV to be positioned to 
cylinder zero. The only parameter 
required is CURDRV. The only parameter 
changed is FDSTAT. 



SEEK *£S7a 



This entry point causes the read/urite 
head of CURDRV to be positioned to the 
cylinder containing STRSCT (see Appendix 
A). The only parameter changed is 
FDSTAT. 



WRTEST $ES7B 



This entry point causes the two bytes of 
data located at the address (and at 
address + 1) contained in CURADR to be 
written into alternating bytes of NUMSCT 
sectors beginning with STRSCT of CURDRV. 
The only parameter changed is FDSTAT. 



WRDDAM *E87E 



This entry point causes a deleted data 
mark to be written to NUMSCT sectors 
beginning with STRSCT of CURDRV. The 
only parameter changed is FDSTAT. 



WRVERF *E8ai 



This entry point causes NUMSCT sectors 
beginning at STRSCT of CURDRV to be 
written from memory starting at the 
address contained in CURADR. CURADR is 
updated to the address of the next byte 
to be read from memory after each sector 
is written. After all sectors have been 
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written to the diskettej they are read 
back to verify their CRCs as checked by 
the routine RDCRC. The only parameters 
changed ars CURADR and FDSTAT. 



WRITSC *EBS4 



This entry point is identical to WRVERF 
with the exception that the written 
sectors are not read back to verify their 
CRCs. The only parameters changed are 
CURADR and FDSTAT. 



When an error occurs* the physical sector number at 
which the error occurred can be computed from the following 



relationship 



STRSCT ■*■ NUMSCT — SCTCNT — 1 



where PSN is the physical sector number at which the error 
occurred. and SCTCNT is a two-byte value contained in 
locations *O00B-000C. 

The fallowing entry points avs also in the firmware but 
have nothing to do with the diskette functions. These entry 
points can be used to access a line printer. 



Name 



Address Function 



LP 1 NIT $EBCO 



This entry point intializes the PIA 
a reset condition. 



from 



LIST SEBCC 



This entry point sends the contents of 
the A accumulator to the line printer. 
If the "paper empty" or "printer not 
selected" status condition is detected, 
the LIST entry point will return with the 
carry flag of the condition code register 
set to one. If these conditions are not 
detected, the carrii flag will be set to 
zero. 



LDATA *EBE4 



This entry point sends a character string 
to the line printer. The string is 
pointed to by the X register and must be 
terminated with an EOT (*04). Prior to 
printing the string. a carriage return 
and a line feed are sent to the printer. 
If a printer error is detected by LDATA. 
it will loop until aborted or until the 
error is corrected. 



LDATA 1 *EBF2 



This entry point performs the same 
function as LDATA with the exception that 
the initial carriage return and line feed 
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are not printed. 

For a complete description of the diskette controller 
module the "Floppy Disk Controller Module User's Guide" 
should be consulted. 
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Mini-Diagnostic Facility 



A mini-diagnostic routine is available in the EXQRdisk 
II diskette controller firmuiare (version numbers less than 
1.2). This routine permits the user to execute any diskette 
controller function a single time or continuously. The 
parameters required by the mini-diagnostic routines are 
similar to those used by the other diskette controller 
functions (Appendix D). The reader should be familiar with 
those parameters before attempting to use the 
mini -diagnostics. 



The follouiing parameters and entry points 
by the mini-diagnostic routine: 



ars required 



Name 



Address Definition 



CUR ADR $0006 



This parameter is automatically set up by 
the mini-diagnostic routine from LDADDR 
(see .below) before each execution of the 
specified function. 



LDADDR *0020 



These two bytes contain the data that 
would normally be placed into CURADR. 
The diagnostic routine will update CURADR 
from LDADDR before each function is 
executed. 



EXADDR *O022 



These two bytes must contain the address 
of the entry point of the function 
(READSC, WRTEST, etc. ) that is to be 
executed by the diagnostic routine. 



ONECON *O024 



This byte should contain a zero if the 

function is to be executed continuously. 

A non-zero value in this location will 

cause the function to only be executed 
once. 



$0060-$0073 



This area contains a two-byte counter for 
each of the possible states returned by a 
function in FDSTAT. Locations *60-61 
contain a counter for the status of "0"; 
locations *62-63 contain a counter for 



CLRTOP «EB90 



This location is the entry point to the 
mini-diagnostic routine that initially 
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zeroes the counters in locations $60-73 
before executing the function. 

TOP *EB"?8 This location is the entry point to the 

mini-diagnostic routine that aill leave 
the counters at locations *60-73 
unchanged before executing the function. 

Single Execution 

In order to execute- a diskette function a single tifi5e> 
rh^ parameters C'JRDRV, STRSCT. NUMSCT. LSGTLN.. and LDADDR 
should be configured as required for the specific function. 
The address of the specific function should then be placed 
into EXADDR. The location ONECON should be initialized with 
a non-zero value. The stack register should be pointing to a 
valid area in memory (the EXbug stack is acceptable). Then, 
the debug monitor command 

EB9a; G 

will give control to the mini-diagnostic routine causing the 
PIA and SSDA to be initialized, CURDRV to be restored, and 
the function in EXADDR to be executed a single time. Upon 
completion of the function, the letter "E" follouied by a 
digit "O" through "9" ujill be printed and control returned to 
the debug monitor. The displayed message uiill indicate the 
completion status of the function as returned in FDSTAT. 

Continuous Execution 



In order to execute a diskette function continuously, 
the parameters CURDRV, STRSCT, NUHSCT LSCTLN, and LDADDR 
should be configured as required for the specific function. 
The address of the specific function should then be placed 
into EXADDR. The location ONECON should be initialized to 
the value of zero. The the debug monitor command 

EB98i G (to start at TOP) 

or 

EB90i (to start at CLRTOP and zero counters) 

will give control to the mini-diagnostic routine. This will 
cause the PIA and SSDA to be initialized, CURDRV to be 
restored, and the function in EXADDR to be executed 
continuously until " one of the two-byte counters is 
incremented to zero. When one of the two-byte counters 
reaches zero, an "E" followed by an error indication will be 
printed at the console and control returned to the debug 
monitor. The error indication following the letter "E" will 
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not be the normal value in the range 0-9. Rather/ it will be 
the ASCII character that corresonds to twice the value of the 
normal error code $30— *39. Thus* the follouing correlation 
exists betiueen the normal error and the printed character 
follQwing the "E": 

Normal Error Printed character 





1 b 

2 d 

3 f 

4 h 

5 J 

6 1 

7 n 

8 p 

9 r 

If the user initializes a counter to the value *FFFF. for 
example. the mini-diagnostic will run continuously until the 

first error of the type monitored by the counter occurs. 
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Diskette Descriptiorij Handling* and Format 



The flexible disk, or diskette, is permanently enclosed 
by a durable, plastic covering. This outside jacket allsufs 
the diskette to be handled and at the same time gives a 
certain degree of protection for the oxide surface within. 
The covering also provides rigidity to the diskette, allowing 
it to be easily inserted into and removed from the diskette 
dr i ves. 

To extend the usable life of a diskette and to maximize 
trouble— free operation, the diskette should be handled with 
reasonable care. The following points of diskette care 
should be followed. Most manufacturers usually list these 
points on the protective envelope of the diskette as a 
reminder. 

1. The diskette should be returned to its protective 
envelope when not in a drive unit. 

2. The diskette in its envelope should be 'stored 
vertically. It should not be stacked or placed 
under heavy pressure as this can cause warping of 
the oxide surface. 

3. Too many diskettes should not be forced into one 
box. 

4. The diskette should not be exposed to any 
magnetizing force in excess of 50 oersted. The 
50 oersted level can be reached about three 
inches away from a typical source such as 
electric motors, transformers, etc. 

5. Diskettes should not be subjected to extremes of 
heat. They should not be kept in direct 
sunlight. Warping can result. 

6. The label on the diskette should only be written 
on with a felt-tipped pen. Pencils, ballpoint 
pens, or extreme pressure from felt-tipped pens 
can emboss the oxide surface within. 

7. The physical oxide surface should never be 
touched. Skin oils transferred to the surface in 
this manner can attract and retain dust and other 
contaminants. 
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8. The surface of the diskette should never be wiped 
or cleaned. Any physical contact with the 
surface should be avoided. 

9. The diskette should never be forced into the 
drive. Neither should the diskette be folded or 
bant. 

10. The door on the diskette drive should not be 
closed before the diskette has been inserted all 
the way. Damage to the drive hub hole can 
result. Likeujise» the door on the drive should 
be f-ully opened before the diskette is removed. 

The diskette may or may not have a wr i te-protect hole 
along the edge that is inserted first into the drive. This 
hole is located 6.25 inches from the right edge as seen from 
above the diskette. When the hole is not covered* the 
diskette is write protected. The hole must be covered in 
order to lurite on the diskette. An opaque adhesive-backed 
label or tape can be used to cover the hole. 

The single-sided diskette is recorded in a format that 
is similar to the single-sided single-density format of an 
IBM-3740 diskette. The detailed format description is 
contained in the IBM document number SA21-9190-3* "IBM 
One-sided Diskette OEM Information"* Appendix B. The format 
described in that appendix is in reference to IBM part number 
2305830. 

The single-sided format is similar to the IBM 3740 
format insofar as the addressing information is concerned. 
The usage and content of the actual sectors and cylinders is 
not necessarily similar. 

The double-sided diskette is recorded in the Motorola 
single-density double-sided format. This format is an 
extension of the single-sided single-density format onto the 
other side of the diskette. Appendix A gives the location of 
the phsyical sectors uith respect to surface and cylinder for 
both single- and double-sided diskettes. 
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Directory Hashing Function 



In order to Speed up a dirsctoru ssarch for s specific 
file name* a hashing function is used to map a file's name 
into one of the directory 's sectors. As a result? the number 
of sectors that have to be read before a match is found or 
not found is minimized. 

All ten bytes of the file name and suffix are used by 
the hashing function. The function computes a number tuhichi 
when added to the physical sector number of the start of the 
directory! is the sector number of the first sector used in a 
linear search of the directory. 

An entry in the directory taill have in its first byte a 
value of zero, indicating that this entry has never been 
used; a value of *FF, indicating that the entry is deleted; 
or an ASCII character, indicating the presence of a file 
name. 

Initially, all directory sectors are filled ufith zeroes. 
New names ar^ added seq.uential ly to the sector identified by 
the hashing function. Netu entries can be made into those 
entries which have a zero or an *FF in their first byte. 
Thus, a search for a name can stop whenever an entry is found 
which has the first byte equal to zero. 

A directory search begins in the sector identified by 
the hashing function. If no entries within this sector 
contain zero in their first byte, and if no match is found/ 
the next sector in the directory is searched. The sectors 
will continue to be searched in this round-robin fashion 
until a match or an entry with first byte of zero is found, 
or until all sectors have been examined. The only time all 
sectors of the directory aTs searched is if every entry 
contains a valid file name or a deleted file name. Thus, 
directory searches are faster if the directory has been 
reorganized with the BACKUP command (section 3.3). 

The following routine is similar to the one used in MDOS 
to perform the directory hashing function. It is documented 
here to allow users who wish to write disk-oriented programs 
to access the directory without using MDOS. 
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Directory Hashing Function 



■» 

* MDQS DIRECTORY HASHING FUNCTION 
* 

* ENTRY 

* EXIT: 

» 
■» 

TMPl 
TMP2 



X = ADDRESS OF 10 BYTE FILE NAME 
AND SUFFIX 

A ACCUMULATOR CONTAINS THE 

HASH CODE — A NUMBER IN THE 
RANGE 0-19, DECIMAL. 



RMB 
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HASH 
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BNE 
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RORA 
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RORA 
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TAB 

ANDB 

CMPB 
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SUBB 

CMPB 

BHI 

ASRA 

ROLB 

STAB 

RTS 
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H. MDOS-Sup ported Software Products 



This Appendix contains a list of the MDOS-Supported 
software products available at the time of publication. 
These products are capable of running in an MDOS environment 
even though some of them have been developed independently. 
All ^SDOS— Supported products are purchased and shipped 
separately from MDOS. At the time of publication/ only the 
follousing supported products are available for MDDS09: 
RASM09, RLOAD, EDIT, and E. 

These descriptions contain a brief discussion of how the 
product is invoked from the MDOS command line. Any 
additional hardware req.uirefflent5 ars also noted. The 
product's manual that is shipped along with its diskette 
should be consulted for details about its operation. 
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H. 1 ASM — M6800 Assembler 



The ASM . command processes source program statements 
written in the M6S00 Assembly Language. The n6S00 Assembler/ 
ASMi translates these source statements into object programs. 

The M6S00 Assembler is invoked from the MDOS command 
line as are other MDOS commands. No additional hardware 
req,uir emen'C s av^ neeaeo s.o run *,inr assciHu^si wvii = 4 <>..•... »..w 
minimum configuration used for MDOS. The format of the 
command line is: 

ASM <name> C; <options>: 

inhere <name> is the name of source file. The source file 
<naffle> is in the standard MDOS file name format 

<file nafflB> C.<suffix>] i::<lagical unit numfaer>3 

The default values of "SA" and "0" avB used if <suffix> and 
<logical unit number> sts not explicitly entered. 

The <Dptions> may be one or more of the options listed 
in the follouiing table. All options except those that 
control the destination of the source listing and the 
destination of the object file can be specified from uiithin 
the source program math the OPT directive. Certain options 
are automatically used as a default condition. These 
conditions can be reversed or overridden by preceding the 
option letter with a minus sign (-). The following options 
avB recognized by the assembler: 

OPTION DEFAULT ATTRIBUTE CONTHOLLED BY OPTION 

Printing of generated code from FCB. 
FDBi and FCC directives 
Print source listing on line printer 
Print source listing on console 
Create object file with name of 
source file and suffix "LX" on same 
logical unit as source file on 
command line 

a=<name>. Create object file with name. <name> 

S -S Print symbol table 

Certain options (L=. 0=> require a terminating comma only if 
other options follow. Options are specified without any 
intervening blanks or separators. 







G 


-G 


L 


-L 


L=«CNi 


-L 
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Each symbol in the symbol table requires eight bytes. 
Thus, if the minimum of 16K bytes of memory is used, the 
M6800 Assembler can accommodate about 300 (decimal) symbols. 

For more details about the M6800 Assembler/ the "ri6800 
Co-Resident Assembler Reference Manual" should be consulted. 
The following enhancements have been made in the MDOS version 
of the MoSOO Assembler over the specifications in its 
reference manual. 

The symbols may contain the special characters period 
<. ) and dollar sign (*); however, the dollar sign may not be 
used as the first character of a symbol. 

The END directive has been changed so that it now has 
the following format: 

END C<expression>3 

where the value of the optional <sxpression> will be placed 
into the S9 record of the object file. This record is used 
to specify the starting execution address of the object file. 
If no expression is specified, the value of zero will be 
used. 

Like other MDOS .commands, the ASM command is sensitive 
to the BREAK and CTL-W keys of the system console. 

The object file produced is in the EXbug-loadafale 
format. The file must be converted into a memory-image file 
before it can be loaded from the diskette into memory. 
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H. 2 ASMIOOO — M141000 Cross Assembler 



The ASMIOOO command processes source program statements 
mritten in the M141000 Assembly Language. ihe rii410OO Cross 
Assembler, ASMIOOO, translates these source statements into 
object programs that can be executed by the M141000 
Simulator, SIMiOOO. 

The M141000 Cross Assemoier is invoneu n um wnc n^^ww 
command line as avs other MDQS commands; however, the Cross 
Assembler requires that the system has a minimum of 24K bytes 
of memory. The format of the command line is: 

ASMIOOO <name 1>C, <name 2>, . . . , <naffle n>a C; <options>: 

ujhere <name i> avs the names of source files. Each file name 
in the .list is in the standard MD03 file name format 

<file name> C.<3uffix>l !::<lo9ical unit number>3 

The default values of "SA" and "0" ava used if <suffix> and 
<logical unit number> st9 not explicitly entered. Up- to 
twenty file names can be accommodated by the assembler. 

The <options> may be one or more of the options listed 
in the following table. All options except those that 
control the destination of the source listing, the 
destination of the object file, and the printing of error 
messages on the printer if no listing is desired, can be 
specified from within the source program uith the OPT 
directive. Certain options are automatically used as a 
default condition. These conditions can be reversed or 
overridden by preceding the option letter with a minus sign 
{-). The following options avs recognized by the assembler: 
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OPTION DEFAULT ATTRIBUTE CONTROLLED BY OPTION 



L 


-L 


L=#CNi 


-L 


L=<naroe>. 


-L 



C C Printing of macro calls 

D D Printing of macro definitions 

E -E Printing of macro expansions 

p F Printing of conditional directives 

Q -Q Printing of generated code from OPLA 

d irective 
H -H Input initial heading from the 

console 

Print source listing on line printer 
Print source listing on console 
Print source listing into diskette 
file <name> (default suffix is "AL". 
default logical unit number is zere>. 
Such files should be printed with the 
COPY command. 

Print error messages only on line 
printer 

Set printed line length to "ddd" 
(decimal) 

Create object file with name <name 1> 
and suffix "AO" on same logical unit 
as <name 1> of command line 
Create object file with name <name> 
Set number of printed lines per page 
to "dd" (decimal). A -P suppresses 
paging. 

Print symbol table 

Print opcode usage statistics table 
Print unassembled code between 
conditional directives 
X -X Print cross reference table 

Certain options (L=. N=, 0=. P=) require a terminating comma 
only if other options follow. Options are specified without 
any intervening blanks or separators. 

Each symbol in the symbol table requires ten bytes. 
Thus, if the minimum of 24K bytes of memory is used, the 
M141000 Cross Assembler can accommodate about 490 (decimal) 
symbolsJ however, if the cross reference option is specified, 
the symbol table requirements differ. In this case, an 
additional ten bytes are required by each symbol for every 
four references to that symbol. If any macro definitions are 
used (either MACR or INST directives), the available symbol 
table space luill be smaller. 

For more details about the M141000 Cross Assembler, the 
"nl41000 Cross Assembler Reference Manual" should be 
consulted. 

Like other MDOS commands, the ASMIOOO command is 
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sensitive to the BREAK and CTL-W keys of the system console. 
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H. 3 ASM3870 — M3S70 Cross Assembler 



The 
written 



ASK3870 command processes source program statsmsnts 
in the M3870 Assembly Language. The M3870 Cross 
Assembler, ASM3S70i translates these source statements into 
object programs that can be executed by the M3S70 Emulator^ 
EM3870. 



The M3S70 Cross Assembler is invoked from the MDOS 
command line as are other MDOS commands; however, the Cross 
Assembler requires that the system has a minimum of 20K bytes 
of memory. The format of the command line is: 



ASM3S70 <name l>Li <name 2>> 



<name n>3 Cj<options>D 



where <name i> are the names of source files. Each file name 
in the list is in the standard MDOS file name format 

<file name> C:.<suffix>3 C:<logical unit number>D 

The default values of "SA" and "0" are used if <suffix> and 
<logical unit numb6r> are not explicitly entered. Up to 
twenty file names can be accommodated by the assembler. 



The <options> may be on 
in the following table. 
control the destination o 
destination of the object 
messages on the printer if n 
specified from within the 
directive. Certain options 
default condition. These 
overridden by preceding the 
(-5. The following options 



e or more of the opt 
All options except 

f the source li 
file, and the print 

o listing is desir 
source program u/i 
are automatically 
conditions can be 

option letter with a 

are recognized by the 



ions listed 

those that 

sting. the 

ing of error 

ed. can be 

th the OPT 

used as a 

reversed or 

minus sign 

assemb ler : 
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OPTION DEFAULT ATTRIBUTE CONTROLLED BY OPTION 



L 


-L 


L=#CN. 


-L 


L=<naine>» 


-L 



C C Printing of macro calls 

D D Printing of macro definitions 

E -E Printing of macro expansions 

P F Printing of conditional directives 

Q -Q Printing of generated code frora DA 

and DC directives 
H -H Input initial heading from the 

console 

Print source listing on line printer 
Print source listing on console 
Print source listing into diskette 
file <name> (default suffix is "AL", 
default logical unit number is zero). 
Such files should be printed with the 
COPY command. 
M -M Print error messages only on line 

printer 

Set printed line length to "ddd" 
(decimal ) 

Create object file uiith name <name 1> 
and suffix "LX" on same logical unit 
as <name 1> of command line 
Create object file with name <name> 
Set number of printed lines per page 
to "dd" (decimal). A -P suppresses 
paging. 

Print symbol table 

Print unassembled code between 
conditional directives 
X -X Print cross reference table 

Certain options (L=; N=j 0=. P=) require a terminating comma 
onlij if other options follou/. Options are specified without 
any intervening blanks or separators. 

Each symbol in the symbol table requires ten bytes. 
Thus# if the minimum of 20K bytes of memory is used, the 
li3870 Cross Assembler can accommodate about 230 (decimal) 
symbolsi however, if the cross reference option is specified, 
the symbol table requirements differ. In this case, an 
additional ten bytes ars required by each symbol for every 
four references to that symbol. If any macro definitions ars 
used (MACR directive), the available symbol table space tuill 
be smaller. 

For more details about the M3870 Cross Assembler, the 
"f13870 Cross Assembler Reference Manual" should be consulted. 

Like other MDOS commands, the ASM3870 command is 
sensitive to the BREAK and CTL-W keys of the system console. 
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H. 4 BASIC — BASIC Interpreter 



The BASIC command processes source program statements 

written in the BASIC language. The BASIC interpreter! BASIC, 

can be used to create, modify* and interpret these source 
statements. 

The BASIC interpreter is invoked from the MDOS command 
line as sre other MDOS commands; however. the interpreter 
requires that the system has a minimum of 20K bytes of 
memory. The format of the command line is: 

BASIC <name 1>C. <name 2>: 

uihere <name 1> is the name of a source program file to be 

loaded or created. and <name 2> can be the name of a file 

into which the source program file is to be saved. Both file 

specifications are of the standard MDOS file name format 

<file name> C.<suffix>2 C:<logical unit number>3 

The default suffix "SA" and the default logical unit number 
zero will be automatically supplied if none are explicitly 
entered. 

If <name 1> is the name of file which already exists in 
the directory, then it must contain a valid BASIC program. 
The contents of the file <name 1> will then be automatically 
loaded into the work space. If <naffle 1> does not exist, it 
will be used to save the contents of the work space when the 
BASIC interpreter is terminated. 

The file <name 2> can optionally be used to save the 
contents of the work space if <name 1> is to be left 
unchanged. If <name 2> is specified, it must be the name of 
a file that does not already exist. 

For a detailed description of the BASIC interpreter, the 
"M6S00 BASIC Interpreter Reference Manual" should be 
consulted. 
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H. 5 E — CRT Text Editar 



The E conanand can be used to create or to modify ASCII 
record files on the diskette. Use of the Editor in 
conjunction with the EXORterm 200/22O or EXORterm 
150/EXORciser system allows the user to perform editing^ 
employing specifically designed features of the EXORterm. 

^1 r? ^ M^^^^^^u i ^ i-w^^jj-^baA £-r*rMn -h H A MFinQ r nmms-nti Tina .::) ^ 

J {1 e C^ U U IMtllia 1 1 W Aa a # t ▼ w r» w w * » w»«i W..W ..*«..«« <. w.. — — -.—.-• 

are other MDOS commands; however/ the Editor req.uires that 
the system has a minimum of 32K bytes of memory. 

For a complete description of the E command's usage? the 
"MASOOEDITORM Resident Editor Reference Manual" should be 
consulted. 
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H. 6 EDIT — Text Editor 



t 



Ths EDIT command can be used to create or tc modif 
ASCII record files on the diskette. The EDIT command is 
invoked from the MDQS command line as are other MDOS 
commands. No additional hardware requirements are needed to 
run the EDIT command other than the minimum configuration 
used for MDOS. 

The EDIT command is invoked with the following command 
line: 

EDIT <name !>{:/ Cname 2>1 

where <name i> is the name of the file to be edited and <name 
2> can be the name of an output or scratch file. Both file 
specifications are in the standard MDOS format: 

<file name> L. <suff ix>3 C:<logical unit number>D 

The default values "SA" and zero are used for the suffix and 
the logical unit number- respectively* if they are not 
explicitly entered. 

If only <Cname 1> is specified on the command line/ then 
it will be the name of the file to be edited. If <name 1> 
already exists- the input will be taken from it. If <name 1> 
does not already exist- then it will be automatically 
created, and all output written to it. 

The second file name specification, <name 2>, can only 
be used if the file to be edited already exists on the 
diskette. Normally, <name 2> is not specified. In this 
case, the EDIT program will automatically create a temporary 
output file called SCRATCH. SA. The output file will be 
created on the same logical unit number as <name 1>. unless a 
specific logical unit number is entered for <name 2>. The 
output file is used to receive the data from <name 1> after 
it has been edited by the operator. When the edit process is 
ended, any unedited portion of the input file <name 1> will 
be copied into the output file. The output file will then 
contain a complete copy of the input file plus any changes 
that were made to it. 

If the default output file is used, the file <name 1> 
will be automatically deleted and the output file renamed so 
it has the same name as the original input file. Thus, as 
far as the operator is concerned, the file <name 1> now 
^««4-ains the results of the edit. <name 1> will, therefore, 
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always be the name of the input file and need not be changed 
as a result of editing it. 

If, however; <naine 2> uias explicitly entered on the 
command line, then <name 1> will not be deleted when the EDIT 
command is terminated. In this uiay,- a set of changes can be 
applied to the input file without affecting the original copy 
of the file. The result of the edit will be in <name 2> 
after the edit is snded. If only a logical unit number is 
entered for the <name 2> file name specification! then the 
result of the edit ufill be on the specified logical unit. 

One of the standard MDOS error messages will be 
riicniaiiQri i? -hhe i n n LI t file <name i> is delete or write 
protected and <name 2> is not specified. Since a protected 
file cannot be deleted/ the edited output file SCRATCH. S A 
will contain the results of the edit; however< the input file 
must be manually deleted and the file SCRATCH. SA must be 
manually renamed by the operator. 

If the file SCRATCH. SA already exists on the diskette 
when the EDIT command is invoked without a <name 2> 
specification! the error message 

** 06 DUPLICATE FILE NAME 

will be displayed. The file to receive the output* whether 
explicitly entered on the command line or implicitly used as 
SCRATCH. SA. cannot exist prior to the edit. 

One of the standard error messages will also be 
displayed if during a cross-drive edit. <name 2> cannot be 
renamed after the original file <name 1> has been deleted. 
This can occur if <name 1> exists on both drives. In this 
case, the edited output will again be intact in the file 
SCRATCH. SAi however, it will have to be renamed manually. 

For a complete description of the EDIT command's usage, 
the "M6800 Co-Resident Editor Reference Manual" should be 
consulted. 

The EDIT command has been changed slightly for MDOS from 
the way it is described in the EDIT command's Manual. In an 
attempt to conform to the MDOS keyboard controls, the RUBOUT 
<DEL) key can be used to backspace a character out of the 
input buffer; however, the CTL-D key cannot be used to 
re-display the current line. In addition, the BREAK key can 
be used to prematurely terminate printing of lines (T 
command) and file searching CN command). Control will be 
returned to the EDIT command processor. The CTL-W can- also 
be used to "hold" the lines for consoles that are CRTs. The 
"F" command (punch -nulls for leader) is invalid. The "A" 
command appends 255 lines into the edit buffer. 
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H. 7 EM3S70 — M3a70 Emulator 



The EM3S70 command is the controlling software for the 
M3S70 Emulator Module. It permits the user to load 3870 
object programs from the diskette; to perform examine and 
change operations on the various programmable registers and 
memory; and to insert* to display and to remove breakpoints 
in the user program. 

The EM3S70 Emulator is invoked from the MDOS command 
line as ave other nDGS commands; however* the Emulator 
requires that the system has a minimum of 20K bytes of memory 
as well as an M3S70 Emulator Module. In addition* the user's 
development system must not contain memory between locations 
*DO00 through *DFFF. inclusive. 



The EM3870 
command line: 



Emulator is invoked from the following 



EM3S70 

For a complete description of the Emulator and its command 
structure* consult the "MC3S70 Development System User's 
©uide". 
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H. 8 FORMiOOO — M141000 Object File Conversion 



The FORMiOOO command takes the output file from the 
M141000 Cross Assembler and converts the data to an ASCII 
record file. The resultant file can then be copied to 
cassette or paper tape via the MDOS COPY command. No 
additional hardware requirefltents ars needed to run the object 
file conversion program other than the minimum configuration 
;<Ag/j^w -(jg run the !*!141000 Cross Assembler. 

The FORMIOOO command is invoked uiith the folloiuing 
command line: 

FORMIOOO <name 1>C> <name 2>2 

where <name 1> is the name of the object output file produced 
by the M141000 Cross Assembler- and <name 2> is the name of 
the file that is to be produced. Both file specifications 
take on the form: 

<file name> C. <suffix>3 C;<logical unit number>3 

If <name 2> is not specified on the command linej then <name 
l>'s file name and logical unit number will be used as 
default values for <name 2>. If either suffix is omitted 
from the command line, then the default values "AO" and "AF" 
uiill be used for <name 1> and <name 2>. respectively. If the 
logical unit number is not specified for <name l>i then the 
default value zero mill be used. 

Once the command has been invoked. the specified 
directories will be searched to ensure that: 

1. <name 1> exists, and 

2. <name 2> does not exist. 

If these conditions are met. <name 2> will be created. <name 
1> will be read and its content converted into ASCII records 
that are written into <name 2>. Each record will be eighty 
bytes of data terminated by a carriage return. A total of 
sixty— six records will be written into <name 3> (64 data 
records and 2 OPLA records). The eighty-character records 
have the following format: 



y 
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COLUMN 

4 5 6 

1 7 4 

XX XX XX XX XX XX YYY PAD 000 THRU 015 



XX XX XX XX XX XX YYY PAD F48 THRU F63 

ZZ ZZ ZZ ZZ ZZ ZZ YYY OPLA TERMS 00 THRU 15 

ZZ ZZ ZZ ZZ ZZ ZZ YYY OPLA TERMS 16 THRU 31 



where "XX" ars the instruction operation codes; "yyY" are the 
arithmetic sums of all "XX" or "ZZ" for that record, and "ZZ" 
are output PLA initialization values. 

During the processing of the command- the BREAK key can 
be depressed at any time to cause a controlled termination of 
the program; however^ the partially-generated output file 
mill have to be deleted manually. 

The output file, <naffle 2>. does not get created with 
space compression as do other MDOS ASCII files. Therefore; 
<Cname 2> must not be edited with the MDOS EDIT command since 
the editor automatically creates space-compressed files. 
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H. 9 FORT — Relocatable FORTRAN Compiler 



The FQRT conwnand processes source program statements 
written in the M6800 FORTRAN Language. The FORTRAN compiler, 
FORTi compiles these source statements into relocatable 
object programs. The output from the FORTRAN compiler must 
be processed by the M6S00 Linking Loader in order to obtain 
an executable object file. 



ine f-UKIKftN COfflplier is invoiieu rram vue iij^u-q uummaiiu 

line as are other MDOS commands; hotueveri the compiler 
requires that a system has a minimum o-f 24K bytes of memory. 
The format of the command line is 

FORT <narae 1>C. <name 2>, . . . , <name n>: Ci<options>l 

where <name i> ars the names of source files. Each file name 
in the list is in the standard MDOS file name format: 

<file name> C.<suffix>3 [::<logical unit number>3 

The default values "SA" and zero ars used if <suffix> and 
<logical unit number> are not explicitly entered. Up to 
twenty^ file names can be acoommodated by the compiler. 

The <options> may be one or more of the options listed 
in the following table. Certain options sre automatically 
used as a default condition. These conditions can be 
reversed or overridden by preceding the option letter with a 
minus sign (-). The following options are recogized by the 
comp i ler : 
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OPTION DEFAULT ATTRIBUTE CONTROLLED BY OPTION 



H -H Input initial heading from the 

console 
l_ -L Print source listing on line printer 

L=#CN» -L Print source listing on console 
L=<naffls> -L Print source listing into diskette 

file <name> (default suffix "AL". 
logical unit number zero). Such 
files should be printed with the COPY 
command. 
N=ddd, N=80 Set printed line length to "ddd" 

(dec imal ) 
a Create object file ujith name <name 1> 

and suffix "RO" on same logical unit 
as <name 1> of command line 
Create object file uiith name <name> 
Set number of printed lines per page 
to "dd" (decimal). A -P suppresses 
paging. 

Print symbol table 

Conditional compilation of statements 
beginning with letter "X" 

Certain options (L=> N=, 0=^ P=) require a terminating comma 
only if other options follouj. Options are specified without 
any intervening blanks or separators. 

For a complete description of the FORTRAN compiler 
consult the "M6S00 Resident FORTRAN Compiler Reference 
Manual". 



0=<name>< 





P=dd. 


P=58 


S 


-B 


X 


-X 
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H. 10 MASM — MACE Cross Assembler 



The MASM command processes source program statements 
ujrittan in a user-de-Pined assembly language. The MACE Crass 
Assembler, MASM. allows the user to define the microuord size 
and instruction field formats for a particular hardware 
configuration as lueil as to process source statements written 
in this format. The object files created by the MACE Cross 
Assembler can be loaded via the MACS Loader and Debug Module 
< MBUG ) . 

The MACE Cross Assembler is invoked from the MDOS 

command line as are other MDOS commandsi however, the Cross 

Assembler req.uires that the system has a minimum of 32K. bytes 
of memory. The format of the command line is: 

MASM <name 1>C> <name 2>, . . . ; <name n>l Ci<options>D 

where <name i> are the names of source files. Each file name 
in the list is in the standard MDOS file name format 

<fil6 narae> C. <suff ix>3 C:<lagical unit number>3 

The default values of "SA" and "O" ars used if <suffix> and 
<logical unit number> are not explicitly entered. 

The <options> may be one or more of the options listed 
in the following table. Certain options sve automatically 
used as a default condition. These conditions can be 
reversed or overridden by preceding the option letter uitli a 
minus sign <-). The following options are recognized by the 
assemb ler : 



V 
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OPTION DEFAULT ATTRIBUTE CONTROLLED BY OPTION 



D=<name>* 


D 


L 


-L 


L=#CNi 


-L 


L=<name>, 


-L 



Build definition table in file <n3me 
1> from command line; default suffix 
is "DT"; default logical unit number 
taken from <name 1> 

Build definition table in file 
<name>i default suffix is "DT" and 
logical unit number is zero 
Print source listing on line printer 
Print source listing on console 
Print source listing into diskette 
file <name> (default suffix is "AL", 
default logical unit number is zero). 
Such files should be printed with the 



N=ddd, 


N=72 








0=<n3me>* 
P=dd, 




P=5S 


T=<name>» 


-T 



M -M Print error messages only on line 

printer 

Set printed line length to "ddd" 
(decimal > 

Create object file with name <name 1> 
and suffix "AQ" on same logical unit 
as <name 1> of command line 
Create object file with name <Iname> 
Set number of prin.ted lines per page 
to "dd" (decimal). A -P suppresses 
paging. 

Specifies name of file containing 
definition tables to be referenced 
during the assembly phase; -T implies 
tables avs in memori) 

X —X Print cross reference table 

Certain options (0=. L=- N=, 0=. P=. T=) req.uire a 
terminating comma only if other options follow. Options are 
specified without any intervening blanks or separators. 

Each symbol in the symbol table requires a variable 
number of bytes depending on the complexity of the microuiord 
definition. If the minimum of 32K bytes of memory is usedi 
the MACE Cross Assembler can accommodate about 8K of symbol 
table. 

For more details about the MACE Cross Assembler. the 
"MACE 29/SOO Development System User's Guide" should be 
consulted. 

Like other MDOS commands, the MASM command is sensitive 
to the BREAK and CTL-W keys of the system console. 
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H. li MBUG - — MACE Loader and Debug Module 



The MBUO command allows a user to load a program from a 
diskette file created by the MACE Cross Assembler into the 
microprogram control storage. MBUG also allows the control 
storage to be examined> changed* and written back into the 
diskette file. 

The MBUS command is invoked from the MDQS command line 

system has a minimum of 32K bytes of memory/ the Memory 
Emulator, and the System Analyzer. The format of the command 
line is 

MBUG C<name l>K/<name 2>3 C; <options>3 

where <name 1> is the name of a file from which a program is 
to be loaded/ and <naffle 2> is the name of an output file. 
Both file names are in the standard MDOS file name format: 

<file name> C. <suffix>3 C:<logical unit number>: 

The default value "AO" will be used for the suffixes of <name 
1> and <name Z> if none aTs explicitly entered. The default 
logical unit number for <name 1> is zero. The default 
logical unit number for <name 2> is taken from the logical 
unit number of <name 1>, 

Only two letters can appear in the <options> field: "V" 

and "Q". The "V" option indicates that <name 1> is to be 

verified against the current contents of memory. If "V" is 
specified/ <name 1> must exist. 

The "Q" option indicates that all addresses entered will 

be interpreted as octal. All displayed addresses will also 

be in octal. If "<3" is not specified, the hexadecimal base 
will be used. 

For a complete description of MBUG, consult the "MACE 
29/SOO Development System User's Guide". 
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H. 12 iiOTEST — Component Tester Executive 



The MDOS version of the MOTEST Component Tester has the 
same functional capabilities as described in the "MOTEST 
Component Tester Module Supplement". The operating procedure 
Qf ^hg MOTEST executive is described in that supplement. 

The MOTEST executive program is invoked by the following 
command line: 

LOAD MOTST; VS 

This MDOS command will both load and execute the executive 
program. 

Since all versions of the MOTEST Component Tester srs 
identical, regardless of the media on uihich they were 
suppliedi the conversion to diskette will greatly speed up 
the amount of time it requires to initially load the program. 

If the program is on either paper tape or cassettfe> it 
can be copied to the diskette by_ using the following MDOS 
command : 

COPY #CR, MOTST. LXj N 

If the program is on an EDOS diskette, it can be copied to 
the MDOS diskette fay using the following command: 

EMCOPY MOTST, . LX 

Once the program is on an MDOS diskette, it must be converted 
into a memory-image file for loading by using the following 
MDOS command: 

EXBIN MOTST; 200 
Thereafer, the LOAD command can be used as described above. 
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H. 13 MPL — MPL Compiler 



The MPL cofflmand processes source program statements 
written in the M6S00 MPL Language. The MPL compiler, MPL^ 
compiles these source statements into assembly language 
source programs. The output from the MPL compiler must be 
assembled suith the M6S00 Macro Assembler. The output from 
the Macro Assembler must be processed by the M6800 Linking 
Loade'P in ordeT' to abtain an executable abject file. 

The MPL compiler is invoked from the MDOS command line 
as are other MDOS commands; hou;ever» the compiler requires 
that a system has a minimum of 56K bytes of memory. The 
format of the command line is 

MPL <name 1>C, <name 2>, . . . , <name n>3 Ci<options>] 

where <name i> are^ the names of source files. Each file name 
in the list is in the standard MDOS file name format: 

<file name> C. <suffix>3 C:<logical unit number>3 

The default values "SA" and zero ars used if <suffix> and 
<logical unit number> ars not explicitly entered. 

The <options> may be one or more of the options listed 
in the following table. Certain options ST15 automatically 
used as a default condition. The sense of an option can be 
reversed by preceding the option letter with a minus sign 
(-). The following options are recognized by the compiler: 

ATTRIBUTE CONTROLLED BY OPTION 



OPTION 




DEFAULT 


L 




-L 


M 




-M 


N 




-N 


a=<n. 


ame 


'> -0 



Produce source listing on the line 

printer 

Print error messages only on the line 

printer 

Sequence numbers are present on each 

source statement 

Generate compiler output (used for 

subsequent assembler input) in the 

file <name>. The file is given the 

default suffix "SA" and default 

logical unit number zero. The "O" 

option, if usedi must be the last 

option specified on the command line. 

Include MPL statements as comments in 

the output file 
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Options are specified without any intervening blanks or 
separators. 

For a complete description of the MPL compiler consult 
the "M6800 Resident MPL Compiler Reference Manual". 

The symbol table requirements for the MPL compiler are 
fairly complex; however. 6000 (dscimal) bytss of symbol table 
space are available. This is sufficient to accommodate 
approximately 200 (decimal) symbols. 
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H. 14 PPLO/PPHI — PROM Programmer I 



The MDOS version of ths PROM Programmer I has the same 
functional capabilities as described in the "PROM Programmer 
Module Supplement". Both versions of the PROM programmer 
(PROMP HI and PROMP LO) are provided on the MDOS diskette in 
the files PPHI. LO and PPLQ. LOi respectively. These files avs 
in the memory— image format to allow them to be loaded into 
memoru directly from the diskette. 

The operating procedure for each version of the PROM 
Programmer I is described in the above-mentioned Supplementj 
howeverj the process of loading the PROM Programmer I from 
the diskette is explained here. 

Either version of the PROM programmer I can be loaded 
and executed from the MDOS diskette by entering the MDOS 
command line 

LOAD PPHIiVG or LOAD PPLOi VG 

depending on uihich version is to be used. If a user program 
on the diskette is to be placed into a PROM, the following 
procedure can be used if the user program loads above the 
resident operating system and MDOS command interpreter. The 
file can be loaded into memory using the MDOS command 

LOAD <name>i V 

ujhere <name> is the file name of the user's program. Since 
MDOS does not destroy memory during initialization, the 
system can be reinitialized and the PROM programmer loaded as 
explained above. 

If the user program overlays the resident MDOSi then it 
must be "relocated" fay changing the file's Retrieval 
Information Block before loading it into memory. The 
following seq_uence of commands should be used to alter a user 
programs's starting load address: 



DUMP <name> 
R FFFF 
78/mmj nn/ 
W 
Q 



The values 



'mm' 



and "nn" represent the hexadecimal numbers of 
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the most significant and least significant bytes of the new 
starting load address (above the resident MDOS). After the 
offset load address has been configured in this manneri the 
above procedure should be followed to load the user program 
and then load and execute the PROM Programmer I. 

A user program whose file has been modified in this 

fashion cannot be executed after being loaded into memory. 

The file should be deleted after it has been placed into the 
PROM. 

If the user has the PROM Programmer I on a non-MDOS 
diskette media, it can be copied to the MDOS diskette using 
the folloujing procedure. 



the commands 

COPY #CR, PPHI. LXj N 
COPY #CR, PPLD. LXi N 



should be used. If the PROM Programmer I is on an EDOS 
diskette the commands 

EMCOPY PPHI, . LX 
EMCOPY PPLO, . LX 

should be used. After the files are on the MDOS' diskette, 
they must be converted into loadable memory-image files using 
the commands: 

EXBIN PPLO; 20 
EXBIN PPHIi 1000 
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H. 15 PROMPROG — PROM Programmer 11/111 



The PROM Programmer II/III is the controlling software 
for the Universal ERQM/PROM Programmer Module. It provides 
the user with a means of programming a variety of 4-bit and 
S-tJit PROMs and EROMs. 

The PROM Programmer II/III is invoked from the MDQS 
command line as ave other nDGS cemmandsi huuievsr; ths PR—. 
Programmer requires that the system contains the PROM 
Programmer II/III Module. The format of the command line is: 

PROMPROS 

For a complete description of the PROM Programmer II/III and 
its command structure, the "PROM Programmer II/III Reference 
Manual" should be consulted. 



.V 
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H. 16 RASM — Relocatable M6800 Macpo Assembler 



The RASM command processes source program statements 
written in the M6SOO/M6eoi Assembly Language. The Macro 
Assemblsrj RASM* translates these source statenients into 
object programs. If programs are assembled using the 
relocatable option/ the M6800 Linking Loader is required to 
create a file that can be loaded from diskette into memory. 

The Macro Assembler is invoked from the MDOS command 
lint as are other MDCS commands; howeveri the Macro Assembler 
requires that the system has a minimum of 24K bytes of 
memory. The format of the command line is: 

RASM <name l>C»<name 2>» . . . . <name n>j Li<options>j 

where <name i> are the names of source files. Each file name 
in the list is in the standard MDOS file name format 

<file name> C.<suffix>3 C:<logical unit number>3 

The default values of "SA" and "0" are used if <suffix> and 
<logical unit nurol3er> are not explicitly entered. Up to 
twenty file names can be accommodated by the assembler. 

The <options> may be one or more of the options listed 
in the following table. All options except those that 
control the destination of the source listing/ the 
destination of the object file, and the printing of error 
messages on the printer if no listing is desired* can be 
specified from within the source program with the OPT 
directive. Certain options are automatically used as a 
default condition. These conditions can be reversed or 
overridden by preceding the option letter with a minus sign 
(-). The following options ars recognized by the assembler: 
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OPTION DEFAULT ATTRIBUTE CONTROLLED BY OPTION 



A -A Meojory— image object file output 

C C Printing of macro calls 

D D Printing of macro definitions 

E -£ Printing of macro expansions 

F F Printing of conditional directives 

Q ~Q Printing of generated code from FCBj 

FDB< and FCC directives 
H -H Input initial heading from the 

console 
t_ -L Print source listing on line printer 

f u../* fc I I D««<t»«-^ 0nii-v«^B 7-i<:-4'-inA nr^ f nn <. n % ^ 

L=<name>, -L Print source listing into diskette 

file <name> (default suffix is "AL"i 
default logical unit number is zero). 
Such files should be printed uiith 
COPY command. 

11 -M Print error messages only on line 

printer 

N=dddj N=72 Set printed line length to "ddd" 

(decimal ) 

a Create object file luith name <name 1> 

and suffix "LX" (non-relocatable), 
suffix "RO" (relocatable), or suffix 
"LQ" (memory-image) on same logical 
unit as <name 1> of command line 
Create object file luith name <name.> 
Set number of printed lines jaer page 
to "dd" (decimal). A -P suppresses 
pag ing. 

Relocatable object file output 
Print symbol table 

Print unassembled code between 
conditional directives 
Print cross reference table 
Use M6S01 instruction mnemonics 
instead of M6800 and create M6801 
object output 

Certain options iL-- N=i 0=1 P=) require a terminating comma 
only if other options follotu. Options ars specified uiithaut 
any intervening blanks or separators. 

Each symbol in the symbol table requires ten bytes. 
Thus/ if the minimum of 24K bytes of memory is used, the 
Macro Assembler can accommodate about 19S (decimal) symbols; 
however. if the cross reference option is specified, the 
symbol table requirements differ. In this case. an 
additional ten bytes are required by each symbol for every 
four references to that symbol. If macro definitions are 
used (MACR directive), the available symbol table space will 
be smaller. For more details about the Macro Assembler, the 



0=s<name>. 





P=dd. 


p=5a 


R 


-R 


S 


-S 


U 


-U 


X 


-X 


z 


-z 
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"M6SOO/M6S01/M6S09 Macro Assembler Reference Manual" should 
be consulted. 

Like other MDOS commands, the RASM conwnand is sensitive 
to the BREAK and CTL-W keys of the system console. 
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H. 17 RASM09 — Relocatable M6a09 Cross Assembler 



The RASM09 command processes source program statements 
written in the M6S09 Assembly Language. The M6809 Cross 
Assembler, RASM09. translates these source statements into 
object programs. RASM09 is the resident macro assembler for 
MD0S09. If programs are assembled using the relocatable 

_ ^ J. J j.v_ I i-^u-i-^^ 1 nuAa-r- \a Taniii-nati T.n CTeatS a filS that 

can be loaded from diskette by the f16e09 Simulator. 

The li6S09 Cross Assembler is invoked from the MDOS 
command line as are other PIDOS commands; however. the Macro 
Assembler requires that the system has a minimum of 32K bytes 
of memory. The format of the command line is: 

RASM09 <name 1>C, <name 2>, . . . » <name n>3 Ci<options>3 

ujhere <naffle i> avs the names of source files. Each file name 
in the list is in the standard MDOS file name format 

<file name> C.<suffix>3 C:<logical unit number>3 

The default values of "SA" and "0" aTe used if <suffix> and 
<logicai unit number> are not explicitly entered. Up to 
twenty file names can be accommodated by the assembler. 

The <options> may be one or more of the options listed 
in the following table. All options except those that 
control the destination of the source listing, the 
destination of the object file, and the printing of error 
messages on the printer if no listing is desired, can be 
specified from within the source program with the OPT 
directive. Certain options are automatically used as a 
default condition. These conditions can be reversed or 
overridden by preceding the option letter with a minus sign 
<-). The following options are recognized by the assembler: 
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OPTION 


DEFAULT 


A 


-A 


C 


C 


D 


D 


E 


-E 


F 


F 


G 


-G 



ATTRIBUTE CONTROLLED BY OPTION 



Memory-image object file output 
Printing of macro calls 
Printing of macro definitions 
Printing of macro expansions 
Printing of conditional directives 
Printing of generated code from FCBi 
FDB# and FCC directives 

H -H Input initial heading from the 

console 

listing on line printer 
listing on console 

listing into diskette 
(default suffix is "AL". 
default logical unit number is zero). 
Such files should be printed with 
COPY command. 

M -« Print error messages only on line 

printer 

N=ddd/ N=72 Set printed line length to "ddd" 

( d e c i ma 1 ) 

Create object file u/ith name <name 1> 

and suffix "LX" (non-relocatable)* 
suffix "RO" (relocatable), or suffix 
"LO" (memory-image) on same logical 
unit as <name 1> of command line- 
Create object file with name <name> 
Set number of printed lines per page 
to "dd" (decimal. A -P suppresses 



L 


-L 


Print 


source 


L=#CN, 


-L 


Print 


source 


L=<name>i 


-L 


Print 


source 






file 


<name> 



0=<name>» 





P=dd, 


p=5a 


R 


-R 


S 


-s 


U 


-u 



paging. 

Relocatable object file output 
Print symbol table 

Print unassembled code between 
conditional directives 
-X Print cross reference table 



Certain options (L=. N=i 0=, P=) require a terminating comma 
only if other options follouj. Options are specified without 
any intervening blanks or separators. 

Each symbol in the symbol table requires ten bytes. 
Thus, if the minimum of 32K bytes of memory is used, the 
M&809 Cross Assembler can accommodate about 700 (decimal) 
symbols; however, if the cross reference option is specifiedi 
the symbol table requirements differ. In this case, an 
additional ten bytes are required by each symbol for every 
four references to that symbol. If macro definitions are 
used <riACR directive), the available symbol table space will 
be smaller. For more details about the M6S09 Cross 
Assembler, the "M6800/M6801/M6809 Macro Assembler Reference 
Manual" should be consulted. 
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Like other MDOS commands, the RASM09 command is 
sensitive to the BREAK and CTL-W keys of the system console. 
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H. IS RLOAD — Linking Loader 



The RLOAD command combines relocatable object files 
created by the M6S00/M6S01/M6a05/M6S0? Macro Assemblers or 
the M6800 FORTRAN Compiler and produces an absolute object 
file in either memory— image or EXbug-loadab le format. 

The Linking Loader is invoked from the MDOS command line 
as sre other MDOS commands; houiever, the Linking Loader 
requires that the system has a minimum of 24K bytes of 
memory. The foriaat of the coiTnTiarid lins is 

RLOAD 

RLOAD uiorks basically the same as described in the "M6800 
Linking Loader Reference Manual"; however* the following 
changes have been made in the MDOS version of RLOAD over the 
specifications in the manual. 

Some commands have been removed from RLOAD since they 
were originally intended for a cassette version of the 
Linking Loader which is no longer supported. These commands 
are: EXBUG. 01. SRCH, SKIP, FILE, and MODU. 

The STR, CUR (uiithoot backslash option), and END 
commands allow the use of either a defined ASCT symbol or a 
numeric constant to the right of the equal sign. 

The default BSCT address that RLOAD will assign is *0020 
if assembly language programs are being linked; however, the 
default address of BSCT will become *0040 if FORTRAN programs 
ars linked. In addition, FORTRAN programs will be 

automatically assigned memory locations so that DSCT and PSCT 
fall on even addresses. Therefore, the CUR commands with the 
backslash option (\) need not be used when linking FORTRAN 
programs; however, if the CUR command with the backslash 
opt-ion is used when linking FORTRAN programs, the user must 
ensure that the supplied number is an even number. 

Programs with uninitialized BSCT and/or DSCT will not be 
allocated space on the diskette when an absolute, 
memory-image file is created; however, all of the BSCT and 
DSCT must be uninitialized for this feature to be of use. 

The format of the load map is slightly improved over the 
examples shown in the Linking Loader manual. Each program's 
symbols are printed separately, in alphabetical order, so 
that an individual symbol can be more easily located in the 
printed maps. 
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The following two caations should be observed when RLOAD 
is invoked from within a CHAIN file. Since CHAIN uses a 
forcing character of a backslash (\)/ two backslash 
characters have to be entered for the RLDAD commands that use 
that character. Systems which have a CRT as a console may 
lose the error messages displayed by RLOAD if errors ars 
inhibited mithin the CHAIN process. Since such errors are 
not reflected in any printed MAPs. it is possible to lose 
sight of the fact that an error occurred* resulting in an 
invalid output file. 



Each symbol in 



RLOAD requires twelve bytes. If the 
minimum memory configuration of 24K is used, about S5 entries 
can be made into the local symbol table and about 265 entries 
can be made into the global symbol table; however. other 
items besides symbols occupy this area. The exact symbol 
table requirements can be calculated from the following: 

SIZE = GST + largest LST 

where SIZE is the total size of the symbol table in bytes and 
GST and LST avs computed from the formulas given below: 

SST = 12 » (5 + ASCT + NC + XDEF + UXREF + NMOD) 

LST = 12 » <5 + ASCT + NC + XDEF + XREF) 



The symbols have the following meanings: 
Symbol Meaning 



GST 


Size 


LST 


Size 




crea 




only 




time 


ASCT 


Numb 


NC 


Numb 


XDth 


Numb 


XREF 


Numb 


UXREF 


Numb 




sati 




defi 


NMOD 


Numb 



of Global Symbol Table, 
of Local Symbol Table. An LST is 
ted for each file loadedi however^ 
one LST is kept in memory at any one 

er of absolute sections. 

er of named common sections. 

er of external definitions. 

er of external references. 

er of external references not 

sfied (defined) by an external 

nition. 

er of files loaded. 



RLOAD divides the available memory so that about three 
fourths of it is available for the global symbol table and 
one- fourth is available for the local symbol table. The 
global symbol table contains all of the external definitions 
and all undefined external references from all loaded files. 
The local symbol table contains the external definitions and 
references that pertain to an individual program. Thus, if a 
global symbol table overflows (GOV error), more memory should 
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be added to the system* or fewer external definitions should 
be made. If a local symbol table overflow occurs (LOV 
error), then more memory should be added or the program 
causing the error should be split into smaller programs. 

The following error messages ars defined in the RLQAD 

manual; however* some expansions and new causes for the 

errors are listed hers. All error messages that are 
generated by RLOAD take on the following format: 

ERR-<cause> 

where <cause> can be any of the following messages: 

<cause> Explanation 



BAE BSCT Assignment Error. The size of the base 
section is greater than *100 bytes. This message 
can be displayed only after a MAP or OBJ command. 

GOV Common Section Overflow Error. The size of a 
common section is greater than *FFFF bytes. 

OAE General Assignment Error. The Linking Loader 
cannot assign absolute memory addresses for one 
or more of the following reasons: 

— The combined length of all sections is 
greater than *FFFF bytes. 

— Due to the location of ASCTs or user assigned 
sections/ the remaining unassigned sections, 
cannot be placed into unassigned areas of 
memory. 

— The automatic sequence in which sections are 
assigned memory locations (BSCT> CSCTj DSCT* 
PSCT) results in the Linking loader being 
unable to assign memory. User specified 
starting and/or ending addresses can possibly 
be used to override the automatic sequence of 
assigning memory to force a successful 
link/load. 

GOV Global Symbol Table Overflow Error. The amount 
of memory available for the global symbol table 
was too small to accommodate all section 
information and external definitions. 

lAM Illegal Address Mode Error. A four-digit 
hexadecimal number will be displayed following 
this error message. This number is the address 
of a reference to a global symbol which is used 
in the program as a one— byte operand; however* 
the most significant byte of this symbol's value 
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is not zero. One byte relocation uiii be 
performed on the byte located at the specified 
address, using only the least significant byte of 
the symbol's value. The object file should be 
examined to ensure it can be executed. 

ICM Illegal Command Error. An entered command uias 
not recognized by the Linking Loader. 

lOR Illegal Object Record Error. A record in the 
input file is not a valid relocatable object 
record. 

T<?v Tiig«3i rrjmmanH .5"P.ta.x Errsr. An error occurred 
in the option or specification field of a 
command. The following causes av^ examples of 
syntax errors: 

— A command separator other than a space, 
semicolon, or carriage return was used. 

— A command (e. g. . OBJA, DEF) mas entered 
without the required equal sign, 

— A <name> luas used when a <:number> was 
required by the command (e.g., CURP=\LABEL) . 

— An invalid section specification luas used 
ujith the DEF command. 

— A non-ASCT symbol mas used to the right of 
the equal sign of a STR. CUR. or END command. 

— A backslash was used with the STR or END 
command s. 

— An undefined global symbol was used to the 
right of the equal sign of the EXIT command. 

— The file/module qualifier was invalid with 
the LOAD or LIB command. 

— A logical unit number greater than 3 was 
specified with a file name. 

— A non-numeric logical unit number was 
specified with a file name. 

— A numeric constant was used after the device 
delimiter of the MO command. 

LOV Local Symbol Table Overflow Error. The amount of 
memory available . for the local symbol table was 
too small to accommodate the section and symbol 
information for a single program. 

MDS Multiply Defined Symbol Error. The symbol in 
error is shown following the MDS message. Only 
one external definition (from files loaded or via 
DEF command) can be encountered by the Linking 
Loader. Only the first definition is valid and 
will be used. 

PHS Phasing Error. The value of a symbol's absolute 
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30V 



UAE 



address assigned at the end of Pass I (prior to 
OBJ command) does not agree uiith the value 
obtained during Pass II (after the OBJ command). 
This error can also occur if a program is being 
searched for during Pass II and it is not found. 

Section Overfloui Error. Tha length of a section 
is greater than *FFFF bytes (non-BSCT section). 

User Assignment Error. This error can occur for 
anyone or more of the following reasons: 



UDS 



UIF 



T C 



If the OBJA command is being 
starting load address is less than 
the OEJA command is being 
ending load address 



usedj the 
*0020. 
used. the 
is greater 



calculated 
than «FFFF. 

— A user assigned start address for a section 
is less than the user assigned end address 
for that section. 

— The user assigned space (end— start) for a 
section is too .small to contain the actual 
section. 

The user assigned addresses for sections 
overlap. 

— The execution address specified with the EXIT 
command is less than the starting load 
address or greater than the ending load 
address of the program. 

— The user assigned starting/ending address for 
BSCT is greater than *0100. 

Undefined Symbol Error. The symbol in question 
is displayed following the UDS message. The 
symbol was not defined during Pass I via a loaded 
program's external defintiions or via a DEF 
command. This error can occur after a LOADi LIB. 
DEFi STR, CUR, or END command. A value of zero 
will be used for the undefined symbol. 

Undefined Intermediate File Error. The IFON 
command was issued but no intermediate file has 
been defined via the IF command. 



In addition, some of the standard MDOS error messages 
can be displayed by RLOAD. The following ars the most 
frequently seen messages; 



*» 03 <name> DOES NOT EXIST 

The file <name> 
command but does 
logical unit. 



was 
not 



used with 
exist on 



the LOAD or LIB 
the specified 
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#* 05 <name> DUPLICATE FILE NAME 



The file <name> was used with OBJAi OBJX, MO. or 
IF commands. These commands req,uire the named 
file to not exist prior to execution. 



*-» 11 DEVICE NOT READY 



A MAP command is trying to uirite to the printer 
which is not ready. 

*■» 14 INVALID FILE TYPE 

The file specified uiith the LOAD or LIB command 
was not a binary record file. 

*■* 24 LOGICAL SECTOR NUMBER OUT OF RANGE 

During Pass II (after OBJA command )j the programs 
loaded required the accessing of allocated 
diskette space outside of the range that was 
calculated as sufficient during Pass I. This can 
occur if different files are loaded during the 
two passes. This message will again occur when 
the EXIT command is issued, resulting in the 
output file being deleted. 

** 41 INSUFFICIENT DISK SPACE 

Any memory-image file for which an appropriate 
contiguous block of space does not exist will 
cause this error. Usually, this occurs when 
creating a file with initialized BSCT or DSCT at 
low memory addresses and PSCT at high memory 
addresses. If an intermediate file is being used 
(which also requires disk space), it is suggested 
that the link/load process be run without the 
intermediate file (using CHAIN for example). Map 
output files also require disk space and can 
cause this error. 
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H. 19 SIMIOOO — 141000 Simulator 



The SIMIOOO command is the controlling software for the 
M141000 Simulator Module. It permits the user to load 141000 
object programs from the diskette! to examine and change the 
various registers and memory, to debug the program, and to 
reujrite the program with changes back to the diskette. 

The SIMIOOO Simulator is invoked from the MDOS command 
line as are other MDOS commands; however, the Simulator 
requires that the system has a minimum of 24K bytes of memory 

03 U,CXA 93 sail i»i-rA^rfV^\rf hrf^«it%4A«i«vh^i ii^^mwak. 

The SIMIOOO Simulator is invoked from the following 
command line; 

SIMIOOO 

For a complete description of the Simulator and its command 
structure, consult the "MC141000/1200 Simulator User's 
Guide". 
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H. 20 USE with MDOS 



Several versions of the Floppy Biskstte Controller 
Module ars available for use uiith MDOS. If a crystal on the 
controller board is used to generate timing for the diskette 
interface. this section is not applicable; however^ if the 
(nemorij clock from the EXORciser bus is being used to generate 
the timing* the folloujing precautions must be tak^n when 
using MDOS and USE together. 

The user clock must run at 1 MHii plus or minus a feu 
percent (variable clock rate acceptable in Series II 
versions)* to permit loading user memory ujith a program from 
a file from the diskette. If the user clock is not near 1 
MHzy the object file should first be converted to an 
EXbug-loadable file and copied to cassette or paper tape in 
the regular MDOS environment. Thsn» the user can load the 
tape via EXbug in his oum environment running with the user 
clock. 

The other precaution is the possibility of having a , PIA 
or ACIA in the user memory generate an IRQ when MDOS Is 
initializing. When memory resides at the same addresses in 
both EXORciser and user systemi the EXORciser memory responds 
when such a redundant location is readi however* both 
locations respond (one in each system) when the EXORciser 
memory is written to. Thus* if an I/O device resides in the 
user's system at an address that is within the range of 
contiguous memory in the EXORciser system* the device will be 
written to when MDOS sizes memory at initialization. It is 
possible* therefore* to configure the I/O device to generate 
an IRQ. MDOS does not run with IRQs pending. Thus, a sujitch 
should be installed to allow the IRQ line to be opened. This 
has been done in the buffer box of USE2B. 

For a more detailed discussion of USE and the Floppy 
Diskette Controller Module one or more of the following three 
manuals should be consulted: "MEXUSE2B User's Guide"* 
"Floppy Disk Contro-ller Module User's Guide"* or the appendix 
of the "USE User's Guide". 
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I. MDOS Equate File Listing 



This appendix contains a modified listing of the fIDOS 
and MD0S09 equate files. Only the pertinent parts the 
assembler output are shown. The leftmost column contains the 
value of the location counter uihich represents the value 
equated to the system symbol. The MDOS equate file can be 
assembled on a user's system if the M6800 Macro Assembler is 
available. The MDOS equate file is shown first, followed by 
the MD0S09 equate file. 



* MDOS VERSION 03. 00 — SYSTEM EQUATE FILE — JULY 25, 1978 
* 

*DEFINE TYPE OF MDOS— RESIDENT MDOS ONLY 

* 
0000 A MDOSF* EQU . => MDOS. 1 => OEM MDOS 
0000 A MD0S9* EQU . => MDOS, 1 => MD0S09 

» 

»SKIP2 MACRO 

* 

* THE GENERATED BYTE IS A "COMPARE INDEX IMMEDIATE". 

* THE EXECUTION OF THE BYTE WILL CHANGE THE CONDITION CODE 

* NO REGISTERS ARE AFFECTED. THUS, A ONE BYTE INSTRUCTION 
» IS FORMED THAT SKIPS FORWARD TWO BYTES. 

» 

SKIP2 MACR 

FCB *8C . 

ENDM 
* 

»SKIP1 MACRO 

* 

» THE SAME CONCEPT AS THE "SKIP2" MACRO IS USED, EXCEPT TH 
» A "BIT TEST ACCUMULATOR A IMMEDIATE" OP CODE IS GENERATE 
» 
SKIPl MACR 

FCB *85 

ENDM 
* 

*SCALL MACRO 

» 
SCALL MACR 

IFEQ NARG-i 

SWI 

FCB \0!. "/.Ol 111 111 

ENDC 
* 

IFNE NARG-1 



(SYSTEM FUNCTION CALL) 
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MDOS Equate File Listing 



0000 



0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OOOA 
OOOB 
OOOC 
OOOD 
OOOE 
OOOF 
0010 
0011 



0000 



FAIL 


» UNDEFI 


NED SWI 


ENDC 






ENDM 






» 






* U C 


ALL 


MAC 


» 






UCALL 


MACS 




IFEQ 


NARG-1 




SWI 






FOB \0! +7.10000000 


ENDC 






» 






IFNE 


NARG-1 




SCALL 






ENDC 






ENDM 






» 






» S E 


M 


A C R C 


» 






SEQ 


MACR 




IFNE 


NARO 




\0 EOU * . 




ENDC 






ORG *+l . 




ENDM 






* 






* S Y 


STEM 


F I 


» 






* . 






* SET 


LOCATION COUNT 


* 






.$SAV 


SET 


* 




ORG 


*0 


* 






■» 






* 








SEQ 


. RESRV 




SEQ 


. RELES 




SEQ 


. OPEN 




SEQ 


. CLOSE 




SEQ 


. GEIRC 




SEQ 


. PUTRC 




SEQ 


. REWND 




SEQ 


. GETLS 




SEQ 


. PUTLS 




SEQ 


. I^EYIN 




SEQ 


. DSPLY 




SEQ 


. DSPLX 




SEQ 


. DSPLZ 




SEQ 


. CKBRK 




SEQ 


. DREAD 




SEQ 


. DWRIT 




SEQ 


.MOVE 




SEQ 


. CMPAR 



CALL ARGUMENT * 



R 



(USER FUNCTION CALL) 



[NUMBERING SEQUENTIAL EQUATES 



UNCTION DEFINITION 

TO FOR THE EQUATE DEFINITIONS 
. SAVE OLD LOCATION COUNT 



RESERVE A DEVICE 

RELEASE A DEVICE 

OPEN A FILE 

CLOSE A FILE 

READ A RECORD 

WRITE A RECORD 

POSITION TO BEGINNING OF FILE 

READ LOGICAL SECTOR 

WRITE LOGICAL SECTOR 

CONSOLE INPUT 

CONSOLE OUTPUT (TERM W/ CR > 

CONSOLE OUTPUT (TERM W/ EOT) 

CONSOLE OUTPUT (TERM W/ EOT, NO C 

CHECK CONSOLE FOR BREAK KEY 

EROM DISK READ 

EROM DISK WRITE 

MOVE A STRING 

COMPARE STRINGS 



.y 
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0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

001 A 

OOIB 

OOIC 

OOID 

OOIE 

00 IF 

0020 

0021 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

002A 

002B 

002C 

002D 

002E 

002F 

0030 

0031 

0032 

0033 

0034 

0035 

0036 

0037 

0038 

0039 

003A 

003B 

003C 

003D 

003E 

003F 



SEQ 


. STCHB 


SEQ 


. STCHR 


SEQ 


. ALPHA 


SEQ 


. NUMD 


SEQ 


. ADDAM 


SEQ 


. SUBAM 


SEQ 


.MMA 


SEQ 


.DMA 


SEQ 


. MDENT 


SEQ 


. LOAD 


SEQ 


. DIRSM 


SEQ 


. PFNAM 


SEQ 


. ALUSM 


SEQ 


. CHANG 


SEQ 


.MDERR 


SEQ 


. ALLOC 


SEQ 


. DEALC 


SEQ 


. EWORD 


SEQ 


. TXBA 


SEQ 


. TBAX 


SEQ 


. XBAX 


SEQ 


. ADBX 


SEQ 


. ADAX 


SEQ 


. ADBAX 


SEQ 


. ADXBA 


SEQ 


. SUBX 


SEQ 


. SUAX 


SEQ 


. SUBAX 


SEQ 


. SUXBA 


BhQ 


. CPBAX 


SEQ 


. ASRX 


SEQ 


. ASLX 


SEQ 


.PSHX 


SEQ 


.PULX 


SEQ 


. PRINT 


SEQ 


.PRINX 


SEQ 


. GETFD 


SFQ 


. PUJHD 


SEQ 


. PUTEF 


SEQ 


. EREAD 


SEQ 


. EWRIT 


SEQ 


. MREAD 


SEQ 


.MWRIT 


SEQ 


. MERED 


SEQ 


. MEWRT 


SEQ 


.BOOT 



STORE BLANKS 

STORE CHARACTERS 

CHECK ALPHABETIC CHARACTER 

CHECK DECIMAL DIGIT 

INCREMENT MEMORY (DOUBLE BYTE) BY 

DECREMENT MEMORY (DOUBLE BYTE) BY 

MULTIPLY (SHIFT LEFT) MEMORY BY A 

DIVIDE (SHI-PT RIGHT) MEMORY BY A 

ENTER MDOS WITHOUT RELOADING 

LOAD A FILE FROM DISK 

DIRECTORY SEARCH AND MODIFY 

PROCESS FILE NAME 

ALLOCATE USER MEMORY 

CHANGE NAME/ ATTRIBUTES 

MDOS ERROR MESSAGE HANDLER 

ALLOCATE DISK SPACE 

RETURN DISK SPACE 

SET ERROR STATUS WORD FOR CHAIN 

TRANSFER X TO B, A 

TRANSFER B, A TO X 

EXCHANGE B, A AND X 

ADD B TO X 

ADD A TO X 

ADD B- A TO X 

ADD X TO B, A 

SUBTRACT B FROM X 

SUBTRACT A FROM X 

SUBTRACT B,A FROM X 

SUBTRACT X FROM B> A 

COMPARE B, A TO X 

SHIFT X RIGHT (ARITHMETIC) 

SHIFT X LEFT (ARITHMETIC/LOGICAL) 

PUSH X ON STACK 

PULL X FROM STACK 

PRINT-TERMINATE WITH GR 

PRINT-TERMINATE WITH EOT 

READ FDR (RESIDENT MDOS ONLY) 

WRITE FDR (RESIDENT MDOS ONLY) 

WRITE EOF (RESIDENT MDOS ONLY) 

DISK READ W/ ERR RETN 

DISK WRITE W/ ERR RETN 

MULTIPLE SECTOR READ 

MULTIPLE SECTOR WRITE 

MULTIPLE SECTOR READ W/ ERR RETUR 

MULTIPLE SECTOR WRITE W/ ERR RETU 

RELOAD MDOS 



0000 



ORG 







* A S 


C I I 








* 






0000 


A 


NUI L 


EQU 





0001 


A 


SOH 


EQU 


1 


0002 


A 


STX 


EQU 


2 



*SAV . RESTORE LOCATION COUNTER 

CONTROL CHARACATERS 

. NULL 

. START OF HEADING 

. START OF TEXT 
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0003 


A ETX 


EQU 


3 




0004 


A EOT 


EQU 


4 




0OO5 


A ENQ 


EQU 


5 




0006 


A ACK 


EQU 


6 




0007 


A BEL 


EQU 


7 




0008 


A Be 


EQU 


8 




0009 


A HT 


EQU 


9 




OOOA 


A LP 


EQU 


*A 




OOOB 


A VT 


EQU 


*B 




OOOC 


A FF 


EQU 


$C 




OOOD 


A CR 


EQU 


fD 




OOOE 


A SO 


EQU 


*E 




OOOF 


A SI 


EQU 


«F 




OOIQ 


A DLE 


EQU 


$10 




0011 


A DCl 


EQU 


*11 




0012 


A DC2 


EQU 


$12 




0013 


A DC3 


EQU 


$13 




0014 


A DC4 


EQU 


*14 




0015 


A NAK 


EQU 


$15 




0016 


A SYN 


EQU 


$16 




0017 


A ETB 


EQU 


$17 




0018 


A CAN 


EQU 


$18 




0019 


A EM 


EQU 


$19 




OOIA 


A SUB 


EQU 


$1A 




OOIB 


A ESC 


EQU 


$1B 




OOIC 


A FS 


EQU 


$1C 




OOID 


A OS 


EQU 


$1D 




OOIE 


A RS 


EQU 


$1E 




00 IF 


A US 


EQU 


$1F 




0020 


A SPACE 


EQU 


$20 




007F 


A RUB OUT 


EQU 


$7f- 






St 

» S P 


E C I 


A L 


C H 


002E 


A SUFDLM 


EQU 


/ 




003B 


A OPTDLM 


EQU 






003A 


A DRVDLM 


EQU 


e , 




0023 


A DEVDLM 


EQU 


'# 




002A 


A FAMDLM 


EQU 


'* 




0080 


A E$FATL 


EQU 


1!<7 






* 

» M D 


S 


SEC 


T 


0000 


A SC«DID 


EQU 







0001 


A SC*CAT 


EQU 


1 




0002 


A SC$LOK 


EQU 


2 




0003 


A SC*DIR 


EQU 


3 




0016 


A SC$DRE 


. EQU 


$16 




0017 


A SC*BB 


EQU 


$17 




0018 


A SC*DOS EQU 


$18 




0080 


A SC$SI2 


: EQU 


128 




OOIA 


A SCSTRK EQU 


26 




0034 


A SC*TKD EQU 


52 




0004 


A SC*CLS EQU 


4 
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END OF TEXT 

END OF TRANSMISSION 

ENQUIRY (WRU - WHO ARE YOU) 

ACKNOWLEDGE 

BELL 

BACKSPACE 

HORIZONTAL TAB 

LINE FEED 

VERTICAL TAB 

FORM FEED 

CARRIAGE RETURN 

SHIFT OUT 

SHIFT IN 

DATA LINK ESCAPE 

DEVICE CONTROL 1 

DEVICE CONTROL 2 

DEVICE CONTROL 4 

DEVICE CONTROL 4 

NEGATIVE ACKNOWLEDGE 

SYNCHRONOUS IDLE 

END OF TRANSMISSION BLOCK 

CANCEL 

END OF MEDIUM 

SUBSTITUTE 

ESCAPE 

FILE SEPARATOR 

GROUP SEPARATOR 

RECORD SEPARATOR 

UNIT SEPARATOR 

SPACE (WORD SEPARATOR) 

DELETE <RUB OUT) 



A R A C T E R 



E Q U A 



E S 



SUFFIX DEL I METER 
OPTIONS DEL I METER 
LOGICAL DRIVER DEL I METER 
GENERIC DEVICE NAME DEL I METER 
FAMILY NAME/ SUFFIX DEL I METER 
FATAL ERROR BIT 

? EQUATES 

DISK ID PHYSICAL SECTOR NUMBER 
CLUSTER ALLOCATION TABLE PHSYICAL 
LOCKOUT CLUSTER TABLE PHYSICAL SE 
DIRECTORY START PHYSICAL SECTOR N 
DIRECTORY END PHYSICAL SECTOR NUM 
BOOT BLOCK PHYSICAL SECTOR NUMBER 
OPERATING SYSTEM PHSYICAL SECTOR 
SECTOR SIZE IN BYTES 
NUMBER OF SECTORS/TRACK (SINGLE S 
NUMBER OF SECTORS/CYLINDER (DOUBL 
NUMBER OF SECTORS / CLUSTER 



T-nA 
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07DO 


A 


SCSMAX EGU 


2000 


0FA4 


A 


SC$MXD EQU 


4004 


0020 


A 


DFCLS$ EQU 


32 






3c 

* D I S K 


I D 






» 




0000 


A 


DID«ID EQU 





0008 


A 


DID4VN EQU 


S 


OOOA 


A 


DID«RN EQU 


10 


OOOC 


A 


DID«DT EQU 


12 


0012 


A 


DID*NM EQU 


IS 


0026 


A 


DID^RB EQU 

* 

* D I R E C 


38 






TOR 


0000 


A 


DIR*NM EQU 





0008 


A 


DIR«SX EQU 


8 


OOOA 


A 


DIRSRB EQU 


10 


OOOC 


A 


DIR«AT EQU 


12 


OOOE 


A 


DIR*NU EQU 
* R . I . B 


14 












« 




0075 


A 


RIB«LB EQU 


117 


0076 


A 


RIB«SL EQU 


lis 


0078 


A 


RIBSLA EQU 


120 


007A 


A 


RIB«SA EQU 


122 






# U N I F I 

* 


E D 


0000 


A 


* 

* 

lOCSTA EQU 





0001 


A 


lOCDTT EQU 


1 


0002 


A 


lOCDBP EQU 


2 


0004 


A 


lOCDBS EQU 


4 


0006 


A 


lOCDBE EQU 


6 


0008 


A 


lOCGDW EQU 


a 


OOOA 


A 


lOCLUN EQU 


10 


OOOB 


A 


I DC NAM EQU 


11 


OOOB 


A 


lOCMLS EQU 


11 . 


OOOD 


A 


lOCSDW EQU 


13 


OOOF 


A 


laCSLS EQU 


15 


0011 


A 


lOCLSN EQU 


17 


0013 


A 


IDCSUF EQU 


19 


0013 


A 


I DC EOF EQU 


19 


0015 


A 


lOCRIB EQU 


21 


0017 


A 


IOC PDF EQU 


23 


OOIB 


A 


lOCDEN EQU 


27 


00 ID 


A 


lOCSBP EQU 


29 


OOIF 


A 


lOCSBS EQU 


31 


0021 


A 


lOCSBE EQU 


33 


0023 


A 


IOC SB I EQU 


35 



HDDS Equate File Listing 



. MAXIMUM NG. 

. MAXIMUM NO. 

. DEFAULT NO. 

SECTOR 



OF USABLE SECTORS (SI 
OF USABLE SECTORS <D0 
OF CLUSTERS 

OFFSETS 



OFFSET TO DISK. ID (8 BYTES) 

OFFSET TO VERSION NUMBER (2 BYTES 

OFFSET TO REVISION NUMBER <2 BYTE 

OFFSET TO DATE (6 BYTES) 

OFFSET TO USER NAME (20 BYTES) 

OFFSET TO RIB ADDRS. (20 BYTES) 



ENTRY 



OFFSETS 



OFFSET TO NAME (8 BYTES) 

OFFSET TO SUFFIX (2 BYTES) 

OFFSET OF ATTRIBUTES (2 BYTES) 

OFFSET TO NOT USED AREA (2 BYTES) 



BINARY 



FILE 



OFFSET 



NUMBER OF BYTES IN LAST SECTOR 
NUMBER OF SECTORS TO LOAD 
MEMORY LOAD ADDRESS 
START EXECUTION ADDRESS 



I/O CONTROL 
OFFSETS 



BLOCK 



ERROR STATUS 

DATA TRANSFER TYPE 

DATA BUFFER POINTER 

DATA BUFFER START ADDRESS 

DATA BUFFER END ADDRESS 

GENERIC DEVICE TYPE/CDB ADDRESS 

LOGICAL UNIT NUMBER 

FILE NAME 

MAXIMUM REFERENCED LSN 

CURRENT SEGMENT DESCRIPTOR WORD 

1ST LOGICAL SECTOR OF CURRENT SEG 

CURRENT LOGICAL SECTOR NUMBER 

FILE NAME SUFFIX 

LOGICAL END OF FILE 

PHYSICAL DISK ADDRESS OF R. I.E. 

FILE DESCRIPTOR FLAGS 

DIRECTORY ENTRY NUMBER 

SECTOR BUFFER POINTER/ INITIAL SIZ 

SECTOR BUFFER START ADDRESS 

SECTOR BUFFER END ADDRESS 

SECTOR BUFFER INTERNAL PTR 
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0025 A lOCSLN EQU 

» U N I F I E 

OOOO A . $SAV SET 

30 OR© 

30 SEQ 

Dl SEQ 

D2 SE<3 

33 SEQ 

04 SEQ 

05 SEQ 

06 SEQ 

07 SEQ 

08 SEQ 

09 SEQ 
OA SEQ 
08 SEQ 
OC SEQ 
OD SEQ 
OE SEQ 
OF SEQ 

10 SEQ 

11 SEQ 

12 SEQ 

13 SEQ 

14 SEQ 

15 SEQ 

16 SEQ 

17 SEQ 
IS SEQ 
19 SEQ 

* 

00 ORG 

* 

» M D S 

» AND 

» 

0100 A MDQS* EQU 

0050 A CBUFL$ EQU 

OOAE A CBUFF* EQU 

OOFE A CBUFP* EQU 

0100 A VERS** EQU 

0102 A REVS$$ EQU 

0104 A KYI$SV EQU 

0106 A ENDOS* EQU 

0108 A ENDUS* EQU 

OlOA A ENDSY* EQU 

OlOE A RIBBA* EQU 

0110 A ENDRV* EQU 

0112 A GDBA* EQU 



I0CSBI+2-I0CSTA . IOCS LENGTH 

D I/O ERROR STATUSE 

* . REMEMBER THE CURRENT LOCATION COU 

$0 . RESET IT TO ZERO TO USE THE SEQ M 

I*NOER . NO ERRORSi NORMAL RETURN 

I*NODV . NO SUCH DEVICE 

I«RESV . DEVICE RESERVED ALREADY 

I«NQRV . DEVICE NOT RESERVED 

I*NRDY . DEVICE NOT READY 

I*IVDV . INVALID DEVICE 

I*DUP£ . DUPLICATE FILE NAME 

I^NONM . FILE NAME NOT FOUND 

I«CLDS . INVALID OPEN/CLOSED FLAG 

I*EOF . END OF FILE 

I4FTYP . INVALID FILE TYPE 

I«DTYP . INVALID DATA TRANSFER TYPE 

I*EDM . END OF MEDIA 

ISBUFO . BUFFER OVERFLOW 

I$CKSM . CHECKSUM ERROR 

I«WRIT . FILE IS WRITE PROTECTED 

I4DELT . FILE IS DELETE PROTECTED 

I*RANG . LOGICAL SECTOR NUMBER OUT OF RANG 

I^PSPC . NO DISK FILE SPACE AVAILABLE 

I*DSPC . NO DIRECTORY SPACE AVAILABLE 

I*SSPC . NO SEGMENT DESCRIPTOR SPACE AVAIL 

I*IDEN . INVALID DIR. ENTRY NO. 

I*RIB . INVALID RIB 

I*DEAL . CAN'T DEALLOCATE ALL SPACE 

ISRECL . BINARY RECORD LENGTH TOO LRGE 

I$SECB . SECTOR BUFFER SIZE ERROR 

. $SAV . RESTORE THE LOCATION COUNTER 



INTERNAL 



LOCATION 



VARIABLE 



EQUATES 



$100 . START OF MDOS ASECT 

SO . COMMAND BUFFER LENGTH 

MD0S*-CBUFL$-2 . COMMAND BUFFER LOCATION 

CBUFF*+CBUFL$ . COMMAND BUFFER SCAN POINTER 

MDOS* . VERSION # 

VERS**+2 . REVISION # 

REVS**+2 , SAVE AREA FOR KEY IN* VECTOR 

KYI*SV+2 . END OF . MDOS 

END0S*+2 , END OF USER PROGRAM AREA 

ENDUS*+2 . END OF SYSTEM (MDOS) RAM 

ENDSY*+4 , RIB BUFFER ADDRESS 

RIBBA*+2 . END OF MDOS ROM VARIABLES 

ENDRV*+2 . GENERIC DEVICE TABLE ADDRESS 
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0114 
0116 
0118 
Oil A 

one 

OllE 
0120 
0145 
016A 



0040 



0001 
0002 
0003 
0004 
OOOS 
0010 
0020 
0O40 
0080 



OOOO 
0001 
0002 
0O03 
0005 
0007 
0008 
0010 
0020 
0040 
0080 



0000 
0002 
0004 
0006 
0007 
OOOS 
OOOA 
OOOC 



A SYERR* EQU 
A SWI*SV EQU 
A SWI«UV EQU 
A IRQ«UV EQU 
A IRQ*SV EQU 
A CHFLS* EQU 
A SYIDCB EQU 
A SYPOCB EQU 
A SYEOCB EQU 

« 

*L G I C A 

A LUCRES EQU 

» I C D T 

A DTSGPP EQU 
DT*OPI EQU 
DT*OPa EQU 
DT*OPU EQU 
DT*NFF EQU 
DT$TRU EQU 
DT*CLS EQU 
DT«SIO EQU 
DT*OUT EQU 
DT«INP EQU 
» 

* I C F D 
* 

FD*FMU EQU 
FD*FMD EQU 
FD?FIiL EQU 
FD*FMB EQU 
FD*FiiA EQU 
FD*FMG EQU 
FD*CMP EQU 
FD$CON EQU 
FDSSYS EQU 
FD*DEL EQU 
FD*WRT EQU 
» 

» U N I F I 
* 
* 
» 
A CDBIOC EQU 
A CDBSDA EQU 
A CDBHAD EQU 
A CDBDDF EQU 
A CDBVDT EQU 
A CDBDDA EQU 
A CDBWST EQU 
A CDBLEN EQU 



GDBA$+2 

SYERR$+2 

SWI$SV+2 

SWI$UV+2 

IRQ*UV+2 

IRQ«SV+2 

CHFLG$+2 

SYIOCB+IOCBLN 

3YP0CB+I0CBLN 



SYSTEM ERROR STATUS WORD 

SWI VECTOR SAVE AREA 

SWI USER VECTOR 

IRQ USER VECTOR 

IRQ VECTOR S?stVE AREA 

CHAIN FUNCTION FLAG WORD 

SYSTEM CONSOLE lOCB 

SYSTEM PRINTER IOCS 

ERR MSS FILE 



A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 



LUNIT NUMBER--BIT DEF. 

7.01000000 . IOCS RESERVED FLAG 

T — BIT DEFINITIONS 

%00000000 . OPEN UPDATE/ INPUT 

%000O0OOl . OPEN INPUT MODE 

7.00000010 . OPEN OUTPUT MODE 

XOOOOOOll . OPEN UPDATE MODE 

•/.OOOOOIOO . NON-FILE FORMAT I/O FLAG 

"/.OOOOIOOO . TRUNCATE FLAG 

XOOOIOOOO . FILE OPEN/CLOSE FLAG 

7.00100OO0 . SECTOR I/O FLAG 

•/.0 1000000 . OUTPUT TRANSFER TYPE 

•/.1 0000000 . INPUT TRANSFER TYPE 



B I T 



DEFINITIONS 



I/O 



•/SOOOOOOOO . USER DEFINED FORMAT < SECTOR 

7.0OOO0O01 . DEFAULT OBJECT REC 'D FORMAT 

XOOOOOOIO . BINARY LOAD FORMAT 

XOOOOOOll . BINARY RECORD FORMAT 

XOOOOOlOl . ASCII RECORD FORMAT 

7.00000111 . ASCI -CONVER TED-BINARY REC 'D FORM 

XOOOOIOOO . SPACE COMPRESSION FLAG 

XOOOIOOOO . CONTIGUOUS ALLOCATION FLAG 

ZOO 100000 . SYSTEM FILE ATTRIBUTE 

7.0100O0O0 . DELETE PROTECTION ATTRIBUTE 

7.10000000 . WRITE PROTECTION ATTRIBUTE 

ED I/O CONTROL DESCRI 

BLOCK OFFSETS 





2 

4 

6 

7 

8 

10 

CDBWST+2 



ADDRESS OF IOCS 
SOFTWARE DRIVER ADDRESS 
HARDWARE ADDRESS 
DEVICE DESCRIPTOR FLAGS 
VALID DATA TYPE 
DEVICE DEPENDENT AREA 
WORKING STORAGE 
CDB LENGTH 
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» C D B D D 


F ~ B 


0001 


A DD*FMC EQU 


7.00O0O0O1 


0002 


A DD$LOO EQU 


XOOOOOOIO 


0004 


A DDSCNS EQU 


XOOOOOIOO 


0008 


A DD*RWD EQU 


%00001000 


0010 


A DD*OCF EQU 


%000 10000 


0020 


A DD$INP EQU 


7.00100000 


0040 


A DD«aUT EQU 


7.01000000 


0080 


A DD*RES EQU 


7.10000000 




» C D B V D 


T 




« 




0004 


A VD*BIN EQU 


XOOOOOIOO 


0008 


A VDSGDB EQU 


%GOOOiOOO 


0010 


A VD«SDA EQU 


%000 10000 


0080 


A VD^NFF EQU 


7.10000000 




^fr D E V I C 


E D R I V 


0000 


•ft" 

A DV«ON EQU 





0003 


A DV«aFF EQU 


3 


0006 


A DV*INT EQU 


6 


0009 


A DV5TRM EQU 


9 


OOOC 


A DV«ID EQU 


12 




* D I S K 


E R M 


• 0000 


-ft- 

A CURDRV EQU 





0001 


A STRSCT EQU 


1 


0003 


A NUMSCT EQU 


3 


0005 


A LSCTLN EQU 


5 


0006 


A CUR ADR EQU 


6 


0008 


A FDSTAT EQU 


8 


OOOB 


A SCTCNT EQU 


11 


OOOD 


A SIDES EQU 


$D 




■itr 

* E R M 


ENTRY 


ESOO 


A OSLDAD EQU 


$ESOO 


EB22 


A FDINIT EQU 


$EB22 


ES53 


A CHKERR EQU 


*EB53 


ES5A 


A PRNTER EQU 


*EB5A 


EB69 


A READSC EQU 


*EB69 


EB6D 


A READPS EQU 


$Ea6D 


EB6F 


A RDCRC EQU 


$EB6F 


EB72 


A RWTEST EQU 


*EB72 


ES75 


. A RESTOR EQU 


*EB75 


ES78 


A SEEK EQU 


$ES78 


EB7B 


A WRTEST EQU 


*ES7B 


■ ■ ES7E 


A WRDDAM EQU 


*EB7E 


ESSl 


A WRVERF EQU 


4ES81 


EB84 


A WRITSC EQU 


*EB84 



I T 



MDGS Eq.u3ts File Listing 



DEFINITIONS 



ASCII-CONVERTED-BINARY IS DEFAUL 
LOGICAL SECTOR I/O FLAG 
CONSOLE FLAG 
REV4IND FLAG 
OPEN/CLOSE FLAG 
INPUT DEVICE FLAG 
OUTPUT DEVICE FLAG 
RE3ERVABLE DEVICE FLAG 



BIT 



DEFINITIONS 



BINARY OBJECT FLAG 

TEMP SDA POINTER FLAG 
NON-FILE FORMAT FLAG 



E R 



ENTRY 



OFFSET 



DEVICE ON OFFSET 

DEVICE OFF OFFSET 

DEVICE INTIALIZATION OFFSET 

DEVICE TERM I NAT I ON OFFSET 

DEVICE CHARACTER INPUT/OUTPUT OFF 

EQUATES 

CURRENT DRIVE NUMBER 

STARTING PHYSICAL SECTOR NUMBER 

NUMBER OF SECTORS TO OPERATE UPON 

# OF BYTES TO READ FROM LAST SECT 

MEMORY ADDRESS FOR DISK TRANSFER 

DISK TRANSFER STATUS 

SECTOR COUNT USED IN DETERMINING 

- ->SINGLEj + -> DOUBLE. SIDED 

POINTS 

BOOTSTRAP THE OPERATING SYSTEM 

INITIALIZE THE DISK'S PIA AND SSD 

CHECK AND PRINT ERROR FROM FDSTAT 

PRINT ERROR FROM FDSTAT 

READ SECTOR < 3) 

READ PARTIAL SECTOR 

READ AND CHECK FOR CRC 

WRITE/READ TEST 

MOVE HEAD TO TRACK O 

POSITION HEAD TO TRACK OF "STRSCT 

WRITE TEST 

WRITE DELETED DATA MARK 

WRITE AND VERIFY CRC 

WRITE SECTOR(S) 
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MDOS Equate File Listing 






* E R C 


J M 


ERR 


R 


EQUATES 


0031 


A 


* 

ER*CRC 


EQU 


'1 




DATA CRC ERROR 


0032 


A 


ER*WRT 


EQU 


'2 




WRITE PROTECltD DISK 


0033 


A 


ER*RDY 


EQU 


'3 




DISK NOT READY 


0034 


A 


ER*MRK 


EQU 


'4 




DELETED DATA MARK ENCOUNTERED 


0035 


A 


ER«TIM 


EQU 


'5 




TIMEOUT 


0036 


A 


ER*DAD 


EQU 


'6 




INVALID DISK ADDRESS 


0037 


A 


ER«SEK 


EQU 


'1 




SEEK ERROR 


0038 


A 


ER*DMA 


EQU 


'8 




DATA ADDRESS MARK ERROR 


0039 


A 


ER*ACR 


EQU 


'9 




ADDRESS MARK CRC ERROR 






* 

* M I S C E 


L L A N 


E 


US EROM EQUATES 


0005 


A 


* 
RETRY* 


EQU 


5 




RETRY COUNT FOR DISK READ/WRITE E 






* 

♦ LINE 


P R I N 


T ! 


Z R EROM EQUATES 


EBCO 


A 


* 
LPINIT 


EQU 


■^ *EBC0 




INIT PRINTER PIA 


EBCC 


A 


LIST 


EQU 


*EBCC 




PRINT CONTENTS OF 'A' 


EBE4 


A 


LDATA 


EQU 


*EBE4 




PRINT STRING, CR/LF 


EBF2 


A 


LDATAl 


EQU 


*EBF2 




PRINT STRING, NO CR/LF 






* 

* E X B U Q 


E Q 


U A 


TES FOR MDOS 






» 


:PARTIAL LIST 


ONLY ) 


F015 


A 


* 
INCHNP 


EQU 


*F015 




INPUT CHARACTER (NO PARITY) 


F018 


A 


OUTCH 


EQU 


«F018 




OUTPUT ONE CHARACTER 


F021 


A 


PCRLF 


EQU 


*F021 




. PRINT LF/CR 


F024 


A 


PDATA 


EQU 


*F024 




. PRINT STRING 


FCFD 


A 


SB IT* 


EQU 


*FCFD 




BIT 7 INDICATES IRQ OCCURRED <IF 


FFIF 


A 


BRKPT* 


EQU 


*FF1F 




. MAID'S BREAKPOINT TABLE (8 FDB'S) 


FF4F 


A 


BKPIN* 


EQU 


*FF4F 




. EXBUG BREAKPOINTS IN MEMORY 


FF53 


A 


AECHO 


EQU 


*FF53 




. INPUT CHARACTER ECHO FLAG (0=>ECH 


FFFB 


A 


IRQ*VC 


EQU 


*FFFB 




. IRQ VECTOR 


FFFA 


A 


SWI*VC 


EQU 


*FFFA 




. SWI VECTOR 


FFFC 


A 


NMI*VC 


EQU 


*FFFC 




. NMI VECTOR 


FF8A 


A 


XSTAK* 


EQU 


*FF3A 




. EXBUG STACK 


F0F3 


A 


MAID* 


EQU 


*F0F3 




. MAID ENTRY POINT 


FF16 


A 


XREG«P 


EQU 


*hf-16 




. MAID P-REG. 


f->lS 


A 


XREG«X 


EQU 


*FFia 




. MAID X-REG. 


FFIA 


A 


XREG«A 


EQU 


*FF1A 




. MAID A-REG. 


FFIB 


A 


XREG*B 


EQU 


*FF1B 




. MAID B-REG. 


hhlC 


A 


XREG*C 


EQU 


*FF1C 




. MAID C-REG. 


FFID 


A 


XREG*S 


EQU 


*FF1D 




. MAID S-REG. 


FF63 


A 


BRKPE* 


EQU 


$FF63 




. END OF MAID BREAKPOINT TABLE 


FCF4 


A 


CNACI* 


EQU 


*FCF4 




. CONSOLE AC I A 






* 

« SPECIAL MACRO FOR 


THE 


CENTRONIX PRINTERS TO PRINT TITLES 






» 


(NO 


LONGER USED) 








TITl.H 


MACR 












TTL \0 












EMDM 
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TOTAL ERRORS 00000 — 00000 



. SSAV 


0000 


. ADAX 


0028 


. ADBAX 


0029 


. ADBX 


0027 


. ADDAM 


0016 


. ADXBA 


002A 


. ALLOC 


0021 


. ALPHA 


0014 


. ALUSM 


OOIE 


. ASLX 


0031 


. ASRX 


0030 


. BOOT 


003F 


. CHANG 


OOIF 


. CKBRK 


OOOD 


. CLOSE 


0003 


. CMPAR 


ooii 


. CPBAX 


002F 


DEALC 


0022 


. DIRSM 


OOIC 


. DMA 


0019 


. DREAD 


OOOE 


. DyPLX 


OOOB 


. DSPLY 


OOOA 


. DSPLZ 


OOOC 


. DWRIT 


OOOF 


. hHEAD 


0039 


. EWORD 


0023 


. EWRIT 


003A 


. GETFD 


0036 


. GETLS 


0007 


. Gt 1 KG 


0004 


. KEY IN 


0009 


. LOAD 


00 IB 


. MDENT 


OOIA 


. MDERR 


0O2O 


. MERED 


003D 


. MEWRT 


003E 


. MMA 


0018 


. MOVE 


0010 


. MREAD 


003B 


. MWRIT 


0030 


. NUMD 


0O15 


. OPEN 


0OO2 


. PFNAM 


OOID 


. PRINT 


0034 


. PRINX 


0035 


. PSHX 


0032 


. PULX 


0033 


. FUTEF 


0038 


. FUTFD 


0037 


. PUTLS 


0008 


. PUTRC 


0005 


. RELES 


0001 


. RESRV 


0000 


. REWND 


0006 














/^» t^ A &^ 


J^^t « ^ 


^^* IT* A V 


rtj^^^t^ 


. STCHB 


0012 


. STCHR 


0013 


. SUA A 


UUelV, 


. auo«n 


KJ\J1. / 


. aVOMA 


wveu 


. SUBX 


002B 


. SUXBA 


002E 


. TBAX 


0025 


. TXBA 


0024 


. XBAX 


0026 


ACK 


0006 


AECHO 


FF53 


BEL 


0007 


BKP IN* 


FF4F 


BRKPE* 


FF63 


BRKPT* 


FFIF 


BS 


ooos 


CAN 


0018 


CBUFF* 


OOAE 


CBUFL* 


0050 


CBUFP4 


OOFE 


CDBDDA 


0008 


CDBDDF 


0006 


CDBHAD 


0004 


CDBIOC 


0000 


CDBLEN 


OOOC 


CDBSDA 


0002 


CDBVDT 


0007 


CDBWST 


OOOA 


CHFLG* 


QUE 


CHKERR 


EB53 


CNACI* 


FCF4 


CR 


OOOD 


CUR ADR 


0006 


CURDRV 


0000 


DCl 


0011 


DC2 


0012 


DC 3 


0013 


DC4 


0014 


DD$CNS 


0004 


DD*FMC 


0001 


DD$INP 


0020 


DD«LDG 


0002 


DD«OCF 


0010 


DD*OUT 


0040 


DD^RES 


ooao 


DD«RWD 


0008 


DEVDLM 


0023 


DFCLS* 


0020 


DID*DT 


OOOC 


DIDSID 


0000 


DIDSNM 


0012 


DID«RB 


0026 


DID«RN 


OOOA 


DID«VN 


0008 


DIR5AT 


OOOC 


DIR«NM 


0000 


DIR«NU 


OOOE 


DIR«RB 


OOOA 


DIR4SX 


OOOS 


Dl F 


0010 


DRVDLM 


003A 


DT$CLS 


0010 


DT$INP 


0080 


DT$NFF 


0004 


DT«OPI 


0001 


DT«OPQ 


0002 


DT«OPP 


0000 


DT^OPU 


0003 


DT*OUT 


004O 


DT«SIO 


0020 


DTSTRU 


OOOS 


DV4INT 


0006 


DV«IO 


OOOC 


DV*OFF 


0003 


DV^QN 


0000 


DV^TRM 


0009 


E*FATL 


0080 


EM 


0O19 


ENDOS* 


0106 


ENDRV? 


Olio 


ENDSY* 


OlOA 


ENDUS* 


0108 


ENQ 


0005 


EOT 


0004 


ER$ACR 


0037 


ER*CRC 


0031 


ER*DAD 


0036 


ER*DMA 


0038 


ER*MRK 


0034 


ER«RDY 


0033 


ERSSEK 


0037 


ER«TIM 


0035 


ER*WRT 


0032 


ESC 


OOIB 


EiU 


0017 


ETX 


0003 


FAMDLM 


002A 


FD«CMP 


OOOS 


FDSCON 


0010 


FD^DFI 


0040 


FD*Fm 


0005 


FD«FMB 


0003 


FD«FMC 


0007 


FD^FMD 


0001 


FD$FML 


0002 


FD$FMU 


0000 


FD«SYS 


0020 


FD*WRT 


0080 


FDINIT 


E822 


FDSTAT 


0008 


FF 


OOOC 


FS 


OOIC 


GDBA$ 


0112 


GS 


OOID 


HT 


0009 


I^BUFO 


OOOD 


I$Cl^SM 


OOOE 


ISCLDS 


0008 


ISDEAL 


0017 


I$DELT 


0010 


IfDSPC 


0013 


ISDTYP 


OOOB 


ISDUPE 


0006 


I$EDF 


0009 


I*EDM 


OOOC 


I«FSPC 


0012 


I*MYP 


OOOA 


I«IDEN 


0015 


I«IVDV 


0005 


ISNODV 


0001 


I*NOER 


0000 


I*NONM 


0007 


I«NORV 


0003 


I*NRDY 


0004 


I«RANG 


0011 


I$RECL 


0018 


I*RESV 


0002 


I$RIB 


0016 


I*SECB 


0019 


I«SSPC 


0014 


I$WRIT 


OOOF 


INCHNP 


F015 


lOCBLN 


0025 


lOCDBE 


0006 


IDCDBP 


0002 


laCDBS 


0004 


lOCDEN 


OOIB 


lOCDTT 


0001 


lOCEOF 


0013 


IDCFDF 


0017 


luCGDW 


OOOS 


lOCLSN 


0011 


lOCLUN 


OOOA 


lOCMLS 


OOOB 


lOCNAM 


OOOB 


lOCRIB 


0015 


lOCSBE 


0021 


lOCSBI 


0023 


lOCSBP 


OOID 


lOCSBS 


OOIF 


lOCSDW 


OOOD 


lOCSLS 


OOOF 


lOCSTA 


0000 


lOCSUF 


0013 


IRQ*SV 


one 


IRQ^UV 


OUA 


IRQ«VC 


FFFS 


KYI*SV 


0104 


! DATA 


EBE4 


LDATAl 


EBF2 


LF 


OOOA 


LIST 


EBCC 


LPINIT 


EBCO 


LSCTLN 


0005 


LUCRES 


0040 


MAID* 


F0F3 


MDOS* 


0100 


HD0S9* 


0000 


MDOSF* 


0000 


NAK 


0015 


NMI«VC 


FhHC 


NULL 


0000 


NUMSCT 


0003 


OPTDLM 


003B 


aSLOAD 


E800 


DUTCH 


FOIS 


PCRLF 


F021 


PDATA 


F024 


PRNTER 


E85A 


RDCRC 


EB6F 


READPS 


E86D 


READSC 


ES69 


RESTOR 


ES75 


RETRY* 


0005 


REVSf* 


0102 


RIB«LA 


0078 


RIB$LB 


0075 


RIB$SA 


007A 


RIB*SL 


0076 


RIBBA* 


OlOE 


RS 


OOIE 


RUBOUT 


007F 


RWTEST 


ES72 


SBIT* 


FCFD 



append: 

SC*BB 


EX I 
0017 


SC$CAT 


0001 


SC«CLS 


0004 


SCSDID 


HDOS 
0000 


Equate 

SC*DIR 


hi ie 
0003 


SC$DOS 


0018 


SC$DRE 


0016 


SC$LOK 


0002 


SCSMAX 


07D0 


SC$MXD 


0FA4 


SC$SI2 


0080 


SC$TKD 


0034 


SC«TRK 


OOIA 


SCTC.NT 


OOOB 


SEEK 


ES7S 


SI 


OOOF 


SIDES 


OOOD 


SO 


OOOE 


SOH 


0001 


SPACE 


0020 


STRSCT 


0001 


5TX 


0002 


SUB 


OOIA 


SUFDLM 


002E 


SWI«SV 


0116 


SWI*UV 


0118 


SWI«VC 


FFHA 


SYEOCB 


016A 


SYERR* 


0114 


SYIOCB 


0120 


SYN 


0016 


SYPOCB 


0145 


US 


OOIF 


VD«BIN 


0004 


VD*GDB 


0008 


VD«NFF 


0080 


VDfSDA 


0010 


VERSSS 


0100 


VT 


OOOE 


WRDDAM 


ES7E 


WRITSC 


EB84 


WRTEST 


EB7B 


WRVERF 


EB81 


XREO*A 


FFIA 


XREG*B 


HKIB 


XREQ*C 


FFIC 


XREG^P 


FF16 


XREG$S 


FFID 


XREG*X 


FFIS 


XSTAK* 


FF8A 
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* 6S09 MDOS VERSION 03.00 — SYSTEM EQUATE FILE — 01/26/79 
* 



•DEFINE TYPE OF MDOS — RESIDENT MDOS ONLY 
* 

0000 A MDOSF$ EQU . =»> MDOS* 1 => OEM MDOS 

0001 A MD0S9$ EQU 1 . => MDOS, 1 => MD0S09 



»SKIP2 MACRO 

* THE GENERATED BYTE IS A "COMPARE INDEX IMMEDIATE". 

» THE EXECUTION OF THE BYTE WILL CHANGE THE CONDITION CODES 



DNLY. 



* NO REGISTERS ARE AFFECTED. THUS, A ONE BYTE INSTRUCTION 

* IS FORMED THAT SKIPS FORWARD TWO BYTES. 
» 

SKIP2 MACR 

FCB «ac . 

ENDM 
* 

*SKIP1 MACRO 

* 

* THE SAME CONCEPT AS THE "SKIP2" MACRO IS USED, EXCEPT THAT 

* A "BIT TEST ACCUMULATOR A IMMEDIATE" OP CODE IS GENERATED. 

* 

SKIPl MACR 

FCB $85 

ENDM 
* 

*SCALL MACRO (SYSTEM FUNCTION CALL) 
» 
SCALL MACR 

IFEQ NARG-1 

SWI 

FCB \0!. 7.01111111 

ENDC 
» 

IFNE NARG-1 

FAIL » UNDEFINED SWI CALL ARGUMENT » 

ENDC 

ENDM 
» • 
»UCALL MACRO <USER FUNCTION CALL) 



Pane 1-12 



APPENDIX I 



HD0S09 Equate File Listing 



0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OOOA 
OOOB 
OOOC 
OOOD 
OOOE 
OOOF 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 



0000 .A 



UCALL 


MACR 




IFEQ 


NARG-1 




SMI 






FCB \0 1+7.10000000 


ENDC 






* 






IFNE 


NARG-1 




SCALL 




ENDC 






ENDM 






* 






» S E 


Q M 


A C R 


» 






SEQ 


MACK 




IFNE 


NARG 




\0 EQvJ * . 




ENDC 






ORG *-i-l . 




ENDM 






* 






* S Y 


STEM 


FUN 


* 






» 






* SET 


LOCATION COUNT TO 


♦ 






. «SAV 


SET 


» 




ORG 


*0 


* 






» 






# 








SEQ 


. RESRV 




SEQ 


. RELES 




SEQ 


. OPEN 




SEQ 


. CLOSE 




SEQ 


. OETRC 




SEQ 


. PUTRC 




SEQ 


. REWND 




SEQ 


. GETLS 




SEQ 


. PUTLS 




SEQ 


. KEYIN 




SEQ 


. DSPLY 




SEQ 


. DSPLX 




SEQ 


. DSPLZ 




SEQ 


. CKBRK 




SEQ 


. DREAD 




SEQ 


. DWRIT 




SEQ 


. MOVE 




SEQ 


. CMPAR 




SEQ 


. STCHB 




SEQ 


. STCHR 




SEQ 


. ALPHA 




SEQ 


. NUMD 




SEQ 


. ADDAM 




SEQ 


. SUB AM 



(NUMBERING SEQUENTIAL EQUATES) 



C T I N 



DEFINITIONS 



FOR THE EQUATE DEFINITIONS 
SAVE OLD LOCATION COUNT 



RESERVE A DEVICE 

RELEASE A DEVICE 

OPEN A FILE 

CLOSE A FILE 

READ A RECORD 

WRITE A RECORD 

POSITION TO BEGINNING OF FILE 

READ LOGICAL SECTOR 

WRITE LOGICAL SECTOR 

CONSOLE INPUT 

CONSOLE OUTPUT (TERM W/ CR ) 

CONSOLE OUTPUT (TERM M/ EOT) 

CONSOLE OUTPUT (TERM W/ EOT, NO CR 

CHECK CONSOLE FOR BREAK KEY 

EROM DISK READ 

EROM DISK WRITE 

MOVE A STRING 

COMPARE STRINGS 

STORE BLANKS 

STORE CHARACTERS 

CHECK ALPHABETIC CHARACTER 

CHECK DECIMAL DIGIT 

INCREMENT MEMORY (DOUBLE BYTE) 

DECREMENT MEMORY (DOUBLE BYTE) 



BY 
BY 
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8 
9 
A 

B 

r 

D 
E 
F 
!0 
!1 
!2 
13 
!4 
!5 
Ih 
U 
!S 
!9 
IPs 

m 

2D 

:e 

i? 

30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
3A 
3B 
3C 
3D 
3E 

3F 

30 









5EQ 


. MMA 








SEQ 


. DMA 








SEQ 


. MDENT 








SEQ 


. LOAD 








SEQ 


. DIRSM 








SEQ 


. PFNAM 








SEQ 


. ALUSM 








SEQ 


. CHANG 








SEQ 


. MDERR 








SEQ 


. ALLOC 








SEQ 


. DEALC 








SEQ 


. EWORD 








BtQ 


. TXBA 








SEQ 


. TBAX 








SEQ 


. XBAX 








SEQ 


. ADBX 








SEQ 


. ADAX 








SEQ 


. ADBAX 








SEQ 


. ADXBA 








SEQ 


. SUBX 








SEQ 


. SUAX 








SEQ 


. SUBAX 








SEQ 


. SUXBA 








SEQ 


. CPBAX 








SEQ 


. ASRX 








SEQ 


. ASLX 








SEQ 


. PSHX 








SEQ 


. PULX 








SEQ 


. PRINT 








SEQ 


.PRINX 








SEQ 


.GEIl-U 








SEG 


. PUTFD 








SEQ 


. PUTEF 








SEQ 


. EREAD 








SEQ 


. EWRIT 








SEQ 


. MREAD 








SEQ 


. MWRIT 








SEQ 


. MERED 








SEQ 


. MEWRT 








SEQ 


. BOOT 






# 


ORG 


. $SAV 






* 










« A S 

JfL 


C I I 


C N T 


0000 


A 


IP 

NULL 


EQU 





0001 


A 


SQH 


EQU 


1 


0002 


A 


STX 


EQU 


2 


0003 


A 


ETX 


EQU 


3 


0004 


A 


EDT 


EQU 


4 


0005 


A 


ENQ 


EQU 


5 


0006 


A 


ACK 


EQU 


6 


0007 


A 


BEL 


EQU 


7 



MULTIPLY (SHIFT LEFT) MEMORY BY A 

DIVIDE (SHIFT RIGHT) MEMORY BY A 

ENTER MOOS WITHOUT RELOADING 

LOAD A FILE FROM DISK 

DIRECTORY SEARCH AND MODIFY 

PROCESS FILE NAME 

ALLOCATE USER MEMORY 

CHANGE NAME/ ATTRIBUTES . 

MDOS ERROR MESSAGE HANDLER 

ALLOCATE DISK SPACE 

RETURN DISK SPACE 

SET ERROR STATUS WORD FOR CHAIN 

TRANSFER X TO B. A 

TRANSFER B. A TO X 

EXCHANGE B, A AND X 

ADD B TO X 

ADD A TO X 

ADD 3, A TO X 

ADD X TO B, A 

SUBTRACT B FROM X 

SUBTRACT A FROM X 

SUBTRACT 3. A FROM X 

SUBTRACT X FROM B. A 

COMPARE B/ A TO X 

SHIFT X RIGHT (ARITHMETIC) 

SHIFT X LEFT (ARITHMETIC/LOGICAL) 

PUSH X ON STACK 

PULL X FROM STACK 

PRINT-TERMINATE WITH CR 

PRINT-TERMINATE WITH EOT 

READ FDR (RESIDENT MDOS ONLY) 

WRITE FDR (RESIDENT MDOS ONLY) 

WRITE EOF (RESIDENT MDOS ONLY) 

DISK READ W/ ERR RETN 

DISK WRITE W/ ERR RETN 

MULTIPLE SECTOR READ 

MULTIPLE SECTOR WRITE 

MULTIPLE SECTOR READ W/ ERR RETURN 

MULTIPLE SECTOR WRITE W/ ERR RETURN 

RELOAD MDOS 

RESTORE LOCATION COUNTER 

ROL CHARACATERS 

NULL 

START OF HEADING 

•START OF TEXT 

END OF TEXT 

END OF TRANSMISSION 

ENQUIRY (WRU - WHO ARE YOU) 

ACKNOWLEDGE 

BELL 
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0008 


A BS 


EQU 


8 


0009 


A HT 


EQU 


9 


OOOA 


A LF 


EQU 


*A 


OOOB 


A VT 


EQU 


9B 


OOOC 


A FF 


EQU 


*C 


OOOD 


A CR 


EQU 


*D 


OOOE 


A SO 


EQU 


*E 


OOOF 


A SI 


EQU 


$F 


0010 


A DLE 


EQU 


*10 


0011 


A DCl 


EQU 


$11 


0012 


A DC2 


EQU 


$12 


0013 


A DC3 


EQU 


$13 


0014 


A DC4 


EQU 


$14 


0015 


A NAK 


EQU 


$15 


0016 


A SYN 


EQU 


$16 


0017 


A ETB 


EQU 


$17 


0018 


A CAN 


EQU 


$18 


0019 


A EM 


EQU 


$19 


OOIA 


A SUB 


EQU 


$1A 


OOIB 


A ESC 


EQU 


$1B 


OOIC 


A FS 


EQU 


$1C 


OOID 


A GS 


EQU 


$1D 


OOIE 


A RS 


EQU 


$1E 


OOIF 


A US 


EQU 


$1F 


0020 


A SPACE 


EQU 


$20 


007F 


A RUBOUT 


EQU 


$7F 




* S P E C I 


A L 


oo;?F 


A SUFDLM 


EQU 




003B 


A OPTDLM 


EQU 


i 


003A 


A DRVDLM 


EQU 




0023 


A DEVDLM 


EQU 


'# 


002A 


A FAMDLM 


EQU 


'» 


0080 


A ESFATL 
* 
» « D 1 


EQU 


1!<7 




3 S 


S E < 


0000 


A SC*DID 


EQU 





0001 


A SC$CAT 


EQU 


1 


0002 


A SC*LOK 


EQU 


2 


0003 


A SC*DIR 


EQU 


3 


0016 


A SC$DRE 


EQU 


$16 


0017 


A SC$BB 


EQU 


$17 


0018 


A SC*DOS 


EQU 


$18 


0080 


A SC*SIZ 


EQU 


128 


OOIA 


A SC*TRK 


EQU 


26 


0034 


A SC*TKD 


EQU 


52 


0004 


A SC*CLS 


EQU 


4 


07D0 


A SC*MAX 


EQU 


2000 


0FA4 


A SC$MXD 


EQU 


4004 


0020 


A DFCLS* 


EQU 


32 
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. BACKSPACE 

. HORIZONTAL TAB 

. LINE FEED 

. VERTICAL TAB 

. FORM FEED 

. CARRIAGE RETURN 

. SHIFT OUT 

. SHIFT IN 

. DATA LINK ESCAPE 

. DEVICE CONTROL 1 

. DEVICE CONTROL 2 

. DEVICE CONTROL 4 

. DEVICE CONTROL 4 

. NEGATIVE ACKNOWLEDGE 

. SYNCHRONOUS IDLE 

. END OF TRANSMISSION BLOCK 

. CANCEL 

. END OF MEDIUM 

. SUBSTITUTE 

. ESCAPE 

. FILE SEPARATOR 

. GROUP SEPARATOR 

. RECORD SEPARATOR 

. UNIT SEPARATOR 

.'SPACE (WORD SEPARATOR) 

. DELETE (RUB OUT) 



CHARACTER 



EQUATES 



. SUFFIX DEL I METER 

. OPTIONS DEL I METER 

. LOGICAL DRIVER DEL I METER 

. GENERIC DEVICE NAME DELIMETER 

. FAMILY NAME/SUFFIX DELIMETER 

. FATAL ERROR BIT 

TOR EQUATES 

. DISK ID PHYSICAL SECTOR NUMBER 

. CLUSTER ALLOCATION TABLE PHSYICAL 

. LOCKOUT CLUSTER TABLE PHYSICAL SEC 

. DIRECTORY START PHYSICAL SECTOR NUM 

. DIRECTORY END PHYSICAL SECTOR NUM 

. BOOT BLOCK PHYSICAL SECTOR NUMBER 

. OPERATING SYSTEM PHSYICAL SECTOR N 

. SECTOR SIZE IN BYTES 

. NUMBER OF SECTORS/TRACK (SINGLE SID 

. NUMBER OF SECTORS/CYLINDER (DOUBLE 

. NUMBER OF SECTORS / CLUSTER 

. MAXIMUM NO. OF USABLE SECTORS <SI 

. MAXIMUM NO. OF USABLE SECTORS (DOU 

. DEFAULT NO. OF CLUSTERS 
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* D I S K 


I D 


0000 


■it 

A DID«ID EQU 





ooos 


A DID«VN EQU 


8 


OOOA 


A DID*RN EQU 


10 


OOOC 


A DID«DT EQU 


12 


0012 


A DID«NM EQU 


18 


0026 


A DID*RB EQU 


38 




» D I R E C 


TORY 


0000 


A DIR«NM EQU 





oooa 


A DIR«SX EQU 


8 


OOOA 


A DIR«RB EQU 


10 


OOOC 


A DIR*AT EQU 


12 


OOOE 


A DIR4NU EQU 


14 




» R . I . B 


B 




» 




0075 


A RIB«LB EQU 


117 


0076 


A RIB«SL EQU 


.118 


0078 


A RIB«LA EQU 


120 


007A 


A RIB*SA EQU 


122 




» U N I F I 
* 


£ D 


0000 


A lOCSTA EQU 





0001 


A IQCDTT EQU 


1 


0002 


A IOC DBF EQU 


2 


0004 


A lOCDBS EQU 


4 


0006 


A lOCDBE EQU 


6 


OOOS 


A lOCGDW EQU 


a 


OOOA 


A IDCLUN EQU 


10 


OOOB 


A IDCNAM EQU 


11 


OOOB 


A lOCMLS EQU 


11 


OOOD 


A lOCSDW EQU 


13 


OOOF 


A lOCSLS EQU 


15 


0011 


A lOCLSN EQU 


17 


0013 


A IDCSUF EQU 


19 


0013 


A lOCEDF EQU 


19 


0015 


A laCRIB EQU 


21 


0017 


A lOCFDF EQU 


23 


OOIB 


A laCDEN EQU 


27 


OOID 


A lOCSBP EQU 


29 


OOIF 


A laCSBS EQU 


31 


0021 


A lOCSBE EQU 


33 


0023 


A IQCSBI EQU 


35 


0025 


A IDCBLN EQU 


IOC SB 



SECTOR 



OFFSETS 



OFFSET TO DISK ID (8 BYTES) 
OFFSET TO VERSION NUMBER <2 BYTES) 
OPPSET TO REVISION NUMBER (2 BYTES) 



OFFSET TO 
OFFSET TO 
OFFSET TO 

ENTRY 



DATE <6 BYTES) 

USER NAME <20 BYTES) 

RIB ADDRS. (20 BYTES) 

OFFSETS 



OFFSET TO NAME (8 BYTES) 

Ui" r DC J I U 3Wr r A A s «i oil &^ f 

OFFSET TO RIB ADDRESS (2 BYTES) 
OFFSET OF ATTRIBUTES (2 BYTES) 
OFFSET TO NOT USED AREA (2 BYTES) 



I N A R Y 



FILE 



OFFSETS 



NUMBER OF BYTES IN LAST SECTOR 
NUMBER OF SECTORS TO LOAD 
MEMORY LOAD ADDRESS 
START EXECUTION ADDRESS 



I / 



CONTROL 



LOCK 



OFFSETS 



. ERROR STATUS 

. DATA TRANSFER TYPE 

. DATA BUFFER POINTER 

DATA BUFFER START ADDRESS 

DATA BUFFER END ADDRESS 

GENERIC DEVICE TYPE/CDB ADDRESS 
. LOGICAL UNIT NUMBER 
. FILE NAME 

. MAXIMUM REFERENCED LSN 
. CURRENT SEGMENT DESCRIPTOR WORD 

1ST LOGICAL SECTOR OF CURRENT SEGM 
. CURRENT LOGICAL SECTOR NUMBER 
. FILE NAME SUFFIX 
. LOGICAL END OF FILE 
. PHYSICAL DISK ADDRESS OF R. I. B. 

FILE DESCRIPTOR FLAGS 

DIRECTORY ENTRY NUMBER 

SECTOR BUFFER POINTER/ INITIAL SIZE 
.. SECTOR BUFFER START ADDRESS. , 

SECTOR BUFFER END ADDRESS 
. SECTOR BUFFER INTERNAL PTR 
I+2-I0CSTA . IOCS LENGTH 
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* U N I F I 


E D ] 




* 




0000 


A . $SAV SET 


* 




ORG 


*0 




« 






SEQ 


I^NOER 




SEQ 


I*NQDV 




SEQ 


I^RESV 




SEQ 


I*NORV 




SEQ 


I*NRDY 




SEQ 


I*IVDV 




SEQ 


I$DUPE 




SEQ 


I«NONM 




SEQ 


I$CLDS 




SEQ 


I^EQF 




SEQ 


I*FTYP 




SEQ 


I$DTYP 




SEQ 


ISEDM 




SEQ 


I*BUFO 




SEQ 


I$CKSM 




SEQ 


I*WRIT 




SEQ 


I$DFl, T 


. 


SEQ 


' I*RANG 




SEQ 


I*FSPC 




SEQ 


I*DSPC 




SEQ 


I«SSPC 




SEQ 


I*IDEN 




SEQ 


I*RIB 




SEQ 


I«DEAL 




SEQ 


I*RECL 




SEQ 


I*SECB 



liDOSO? Eq^uate File Listing 



I/O 



ERROR 



STATUSES 



. REMEMBER THE CURRENT LOCATION COUN 
RESET IT TO ZERO TO USE THE SEQ MA 

. NO ERRORS, NORMAL RETURN 

. NO SUCH DEVICE 

. DEVICE RESERVED ALREADY 

. DEVICE NOT RESERVED 

. DEVICE NOT READY 

. INVALID DEVICE 

. DUPLICATE FILE NAME 

. FILE NAME NOT FOUND 

. INVALID OPEN/CLOSED FLAG 

. END OF FILE 

TWwALID FILE TYPE 

. INVALID DATA TRANSFER TYPE 

. END OF MEDIA 

. BUFFER OVERFLOW 

. CHECKSUM .ERROR 

. FILE IS WRITE PROTECTED 

. FILE IS DELETE PROTECTED 

. LOGICAL SECTOR NUMBER OUT OF RANGE 

. NO DISK FILE SPACE AVAILABLE 

. NO DIRECTORY SPACE AVAILABLE 

. NO SEGMENT DESCRIPTOR SPACE AVAIL 

. INVALID DIR. ENTRY NO. 

. INVALID RIB 

. CAN'T DEALLOCATE ALL SPACE 

. .BINARY RECORD LENGTH TOO LRGE 

. SECTOR BUFFER SIZE ERROR 



ORG 



*SAV 



RESTORE THE LOCATION COUNTER 







» M D Q S 


INTER 






* 


A N 


D L C 


0100 


A 


MDOS$ 


EQU 


flOO 


0050 


A 


CBUFL? 


EQU 


SO 


OOAE 


A 


CBUFF$ 


EQU 


MD0S«-CBUF 


OOFE 


A 


CBUFP* 


EQU 


CBUFF*+CBL 


0100 


A 


VERS** 


EQU 


MDOS* 


0102 


A 


REVS** 


EQU 


VERS**-»-2 . 


0104 


A 


KYI*SV 


EQU 


REVS**+2 : 


01O6 


A 


ENDOS* 


EQU 


KYI«SV+2 . 


0108 


A 


ENDUS* 


EQU 


END0S«+2 . 


OlOA 


A 


ENDSY* 


EQU 


ENDUS«+2 . 


OlOE 


A 


RIBBA* 


EQU 


ENDSY*+4 . 


0110 


A 


ENDRV* 


EQU 


RIBBA*+2 . 


0112 


A 


GDBA* 


EQU 


ENDRV*+2 . 


0114 


A 


SYERR* 


EQU 


GDBA«+2 


0116 


A 


SWI*SV 


EQU 


3YERR*+2 . 



N A L 



VARIABLE 



A T I N 



EQUATES 



START OF MDOS ASECT 

COMMAND BUFFER LENGTH 
.*-2 . COMMAND BUFFER LOCATION 
-L* . COMMAND BUFFER SCAN POINTER 

VERSION # 

REVISION # 

SAVE AREA FOR KEY IN* VECTOR 

END OF MDOS 

END OF USER PROGRAM AREA 

END OF SYSTEM <MDOS) RAM 

RIB BUFFER ADDRESS 

END OF MDOS ROM VARIABLES 

GENERIC DEVICE TABLE ADDRESS 

SYSTEM ERROR STATUS WORD 

3WI VECTOR SAVE AREA 
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one 

OllA 

one 

0141 

0166 



0040 A 



0000 
OOOl 
0002 
0003 
0004 
0008 
0010 
0020 
0040 
0080 



0000 
0001 
0002 
0003 
0005 
0007 

0008 
0010 
0020 
0040 

0080 



0000 
0002 
0004 
0006 
0007 
0008 
OOOA 
OOOC 



0001 



A SWI*UV EQU 

A CHFLG* EQU 

A SYIOCB EQU 

A SYPQCB EQU 

A SYEDCB EQU 

* 

»L S I C 

LUCRES EQU 

* 

* I C D T 

* 

A DT«aPP EQU 
A DT*aPl EQU 
A DT«OPa EQU 
A DTSOPU EQU 
A DTSNFF EQU 
A DT*TRU EQU 
A DT«CLS EQU 
A DT«SIO EQU 
A DT*OUT EQU 
A DT*INP EQU 

* 

» I a C F D 

A FD*FMU EQU 
A FDSFMD EQU 
A FD«FML EQU • 
A FD*FMB EQU 
A FD«FMA EQU 
A FD*FMC EQU 



SWI«SV+2 . SWI USER VECTOR 
SWI«UV+2 . CHAIN FUNCTION FLAG WORD 
CHFLS«+2 . SYSTEM CONSOLE IOCS 
SYIOCB+IOCBLN . SYSTEM PRINTER IOCS 
SYPOCB+IOCBLN . ERR MSG FILE 

AL UNIT NUMBER--BIT DEF. 

"/iOlOOOOOO . IOCS RESERVED FLAG 

■J — BIT DEFINITIONS 



7.00000000 . OPEN UPDATE/ INPUT 

/iOOOOOOOi OPEN INPUT MODE 

XOOOOOOIO . OPEN OUTPUT MODE 

XOOOOOOll . OPEN UPDATE MODE 

7.00000 lOO . NON-FILE FORMAT I/O FLAG 

%00OO10OO . TRUNCATE FLAG 

XOOOIOOOO . FILE OPEN/CLOSE FLAG 

%00 100000 . SECTOR I/O FLAG 

7.01000000 . OUTPUT TRANSFER TYPE 

7.10000000 . INPUT TRANSFER TYPE 



BIT 



DEFINITIONS 



A FD*CMP EQU 
A FD*CON EQU 
A FDSSYS EQU 
A FD*DEL EQU 
A FD$WRT EQU 
» 

* U N I F I E 

A CDBIOC EQU 

A CDBSDA EQU 

A CDBHAD EQU 

A CDBDDF EQU 

A CDBVDT EQU 

A CDQDDA EQU 

A CDBWST EQU 

A CDBLEN EQU 
* 

* C D B D D F 

A DD*FMC EQU 



xoooooooo 
xoooooooi 

%OG000010 
7.00000011 
%00000101 
7.00000111 

XOOOOIOOO 
%000 10000 
7.00100OO0 
7.01000000 
7.10000000 



USER DEFINED FORMAT (SECTOR I/O 
DEFAULT OBJECT REC 'D FORMAT 
BINARY LOAD FORMAT 
BINARY RECORD FORMAT 
ASCII RECORD FORMAT 
ASCI-CONVERTED-BINARY REC'D FORMAT 

SPACE COMPRESSION FLAG 
CONTIGUOUS ALLOCATION FLAG 
SYSTEM FILE ATTRIBUTE 
DELETE PROTECTION ATTRIBUTE 
WRITE PROTECTION ATTRIBUTE 



I/O 
B L 



CONTROL 



D E S C R I 



C K 



OFFSETS 





2 

4 

6 

7 

8 

10 

CDBWST+2 



ADDRESS OF IOCS 
SOFTWARE DRIVER ADDRESS 
HARDWARE ADDRESS 
DEVICE DESCRIPTOR FLAGS 
VALID DATA TYPE 
DEVICE DEPENDENT AREA 
WORKING STORAGE 
CDB LENGTH 



B I T 



DEFINITIONS 



7.0000000 1 



ASCII-CONVERTED-BINARY IS DEFAULT 
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0002 


A DD*LOe EQU 


"/.OOOOOOIO 


0004 


A DD*CNS EQU 


7.00OO0100 


0008 


A DD*RWD EQU 


7.00001000 


0010 


A DD«OCF EQU 


XOOO 10000 


0020 


A DD$INP EQU 


XOOIOOOOO 


0040 


A DD*OUT EQU 


%0 1000000 


0080 


A DD*RES EQU 


% 10000000 




» C D B V D 


T 


0004 


A VD*BIN EQU 


XOOOOOIOO 


0008 


A VD*GDB EQU 


7.00001000 


0010 


A VD«SDA EQU 


%000 10000 


0080 


A VD*NFF EQU 


7.10000000 




* 

» D E V I C 


E D R I V 




» 




0000 


A DV*ON EQU 





0003 


A DV*QFF EQU 


3 


0006 


A DV«INT EQU 


6 


0O09 


A DV*TKM EQU 


9 


OOOC 


A DV*ID EQU 


12 




♦ DISK 


E R M 


0000 


A CURDRV EQU 





0001 


A STRSCT EQU 


1 


0003 


A NUMSCT EQU 


3 


0005 


A LSCTLN EQU 


5 


0006 


A CUR ADR EQU 


6 


0008 


A FDSTAT EQU 


8 


OOOB 


A SCTCNT EQU 


11 


OOOD 


A SIDES EQU 
* 

« E R M 


*D 




ENTRY 


EBOO 


A DSLDAD EQU 


*ES00 


E822 


A FDINIT EQU 


$E822 


ES53 


A CHKERR EQU 


*EB53 


ES5A 


A PRNTER EQU 


$EB5A 


ES69 


A READSC EQU 


*EB69 


ES6D 


A READPS EQU 


$EB6D 


E86F 


A RDCRC EQU 


*EB6F 


EB72 


A RWTEST EQU 


*E872 


E875 


A RESTOR EQU 


*E875 


E87S 


A SEEK EQU 


«E878 


EB7B 


A WRIEST EQU 


$EB7B 


ES7E 


A WRDDAM EQU 


*E87E 


EBBl 


A WRVERF EQU 


*EB81 


ESS4 


A WRITSC EQU 


*E884 




* E R M 


ERROR 




* 





MD0S09 Equate File Listing 



LOGICAL SECTOR I/O FLAG 
CONSOLE FLAG 
REWIND FLAG 
OPEN/ CLOSE FLAG 
INPUT DEVICE FLAG 
OUTPUT DEVICE FLAG 
RESERVABLE DEVICE FLAG 



BIT 



DEFINITIONS 



BINARY OBJECT FLAG 
TEMP GDB POINTER FLAG 
TEMP SDA POINTER FLAG 
NON-FILE FORMAT FLAG 



ENTRY 



OFFSETS 



DEVICE ON OFFSET 

DEVICE- OFF OFFSET 

DEVICE I NT I AL I Z AT I ON OFFSET 

DEVICE TERMINATION OFFSET 

DEVICE CHARACTER INPUT/OUTPUT OFF 

EQUATES 

CURRENT DRIVE NUMBER 
STARTING PHYSICAL SECTOR NUMBER 
NUMBER OF SECTORS TO OPERATE UPON 
# OF BYTES TO READ FROM LAST SECTOR 

MEMORY ADDRESS FOR DISK TRANSFER 
DISK TRANSFER STATUS 

SECTOR COUNT USED IN DETERMINING E 
>S INGLE; + -> DOUBLE SIDED 

POINTS 

BOOTSTRAP THE OPERATING SYSTEM 

INITIALIZE THE DISK'S PIA AND SSDA 

CHECK AND PRINT ERROR FROM FDSTAT 

PRINT ERROR FROM FDSTAT 

READ SECTOR (S) 

READ PARTIAL SECTOR 

READ AND CHECK FOR CRC 

WRITE/ READ TEST 

MOVE HEAD TO TRACK 

POSITION HEAD TO TRACK OF "STRSCT" 

WRITE TEST 

WRITE DELETED DATA MARK 

WRITE AND VERIFY CRC 

WRITE SECTOR <S) 

EQUATES 
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0031 


A ER*CRC EQU 


'1 


0032 


A ER^WRT EQU 


'2 


0033 


A ER*RDY EQU 


'3 


0034 


A ER*MRK EQU 


'4 


0035 


A ER*TIM EQU 


'5 


0036 


A ER$DAO EQU 


'6 


0037 


A ER*SEK EQU 


'7 


0038 


A ER^DMA EQU 


'8 


0039 


A ER*ACR EQU 


'9 




* M I S C E 


L L A N 


0005 


■it 

A RETRY* EQU 


5 




* L I N E 


P R I N 


EBCO 


■ft 
A LPINIT EQU 


*EBCO 


EBCC 


A LIST EQU 


*£3CG 


SBE4 


A LDATA EQU 


5EBE4 


EBF2 


A LDATA 1 EQU 


*£BF2 




* E X B U G 


E Q 




* < INCLUDES AL 


J^015 


* 

A INCHNP EQU 


*F015 


FOIS 


A DUTCH EQU 


*F01S 


F021 


A PCRLF EQU 


*F021 


F024 


A PDATA EQU 


*F024 


FCFD 


A SB IT* EQU 


*FC}-D 


FF24 


A BRKPT* EQU 


*FF24 


FF54 


A BKPIN* EQU 


*FF54 


FF58 


A AECHO EQU 


*FF5a 


FFF2 


A SW3*VC EQU 


*FFF2 


FFF4 


A SW2*VC EQU 


*FFF4 


FFF6 


A FIR*VC EQU 


*FFF6 


FFFS 


A IRQ*VC EQU 


$}-Hh8 


FFFA 


A SWI*VC EQU 


*FFFA 


FFFC 


A NMI$VC EQU 


*FFFC 


FF8F 


A XSTAK* EQU 


*FF8F 


F0F3 


A MAID* EQU 


$F0F3 


FF16 


A XREG«P EQU 


*FF1A 


hhlS 


A XREG*U EQU 


*FFia 


FFIA 


A XREG*Y EQU 


*FF1A 


FFIC 


A XREG*X EQU 


*FF1C 


FFIE 


A XREGSD EQU 


*FF1E 


FFIF 


A XREG*B EQU 


*FF1F 


FF20 


A XREG*A EQU 


*FF20 


FF21 


A XREG*C EQU 


*FF21 


FF22 


A XREG*S EQU 


$FF22 


FF68 


A BRKPE* EQU 


$FF6a 


FCF4 


A CNACI* EQU 


*FCF4 


FF72 


A LINES* EQU 


*FF92 



MD0S09 Eciuats File Listing 



DATA GRC ERROR 

WRITE PROTECTED DISK 

DISK NOT READY 

DELETED DATA MARK ENCOUNTERED 

TIMEOUT 

INVALID DISK ADDRESS 

SEEK ERROR 

DATA ADDRESS MARK ERROR 

ADDRESS MARK CRC ERROR 



EOUS EROM EQUATES 

RETRY COUNT FOR DISK READ/WRITE ER 

TER EROn EQUATES 

. INIT PRINTER PIA 

, PRINT CONTENTS OF 'A' 

, PRINT STRING, CR/LF 

. PRINT STRING, NO CR/LF 

UATES FOR MDOS 

.L REFERENCES BUT ROLLOUT) 

. INPUT CHARACTER (NO PARITY) 
. OUTPUT ONE CHARACTER 
. PRINT LF/CR 
. PRINT STRING 

BIT 7 INDICATES IRQ OCCURRED (IF 0) 

. MAID'S BREAKPOINT TABLE (8 FOB'S) 

. EXBUG BREAKPOINTS IN MEMORY 

. INPUT CHARACTER ECHO FLAG <0=>ECHO) 

. SWI 3 VECTOR 

. SWI 2 VECTOR 

. FAST IRQ VECTOR 

. IRQ VECTOR 

. SWI VECTOR 

. NMI VECTOR 

. EXBUG STACK 

. MAID ENTRY POINT . 

. MAID P-REG. 

. MAID U-REG. 

. MAID Y-REG. 

. MAID X-REG. 

. MAID DP-REG. 

. MAID B-REG. 

. MAID A-REG. 

. MAID C-REO. 

. MAID S-REG. 

END OF MAID BREAKPOINT TABLE 

. CONSOLE AC I A 
SEARCH/ LOAD /VERIFY BUFFER 
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MDCS09 Equate File Listing 



F9CF A OCHAR* EQU $F9CF OUTPUT CHAR ROUTINE WITHOUT NULL PAD 
FF02 A XPEED* EQU $FF02 TERMINAL SPEED FLAG 
FF67 A CAS*ET EQU $FF67 PUNCH ON FLAS 
» 

» SPECIAL MACRO FOR THE CENTRONIX PRINTERS TO PRINT TITLES 
» (NO LONGER USED) 
TITLE MACR 
TTL \0 
ENDM 

OPT LIST 
» 
« SPECIAL OPTION — TURN ON THE LISTING 

TITLE (SYMBOL TABLE) 

END 
TOTAL ERRORS 00000 — 00000 
TOTAL WARNINGS 00000 — 00000 



. *SAV 


OOOO 


. ADAX 


0028 


. ADBAX 


0029 


. ADBX 


0027 


. ADDAM 


0016 


. ADXBA 


002A 


. ALLOC 


0021 


. ALPHA 


0014 


. ALUSM 


OOIE 


. ASLX 


0031 


. ASRX 


0030 


. BOOT 


003F 


. CHANG 


00 IF 


. CKBRK 


OOOD 


. CLOSE 


0003 


. CMPAR 


001 i 


. CPBAX 


002F 


. DEALC 


0022 


. DIRSM 


OOIC 


. DMA 


0019 


. DREAD 


OOOE 


. DSPLX 


OOOB 


. DSPLY 


OOOA 


. DSPLZ 


OOOC 


. DWRIT 


OOOF 


. ERE AD 


0039 


. EWORD 


0023 


. EWRIT 


003A 


. GETFD 


0036 


. GtlLS 


0007 


. GETRC 


0004 


. I<.EYIN 


0009 


. LOAD 


OOIB 


. MDENT 


OOIA 


. MDbKR 


0O20 


. MERED 


003D 


. MEWRT 


003E 


. MMA 


0018 


. MOVE 


0010 


. MREAD 


003B 


. MWRIT 


003C 


. NUMD 


0015 


. OPEN 


0002 


. PFNAM 


OOID 


. PRINT 


0034 


. PRINX 


0035 


. PSHX 


0032 


. PULX 


0033 


. PUTEF 


0038 


. PUTFD 


0037 


. PUTLS 


0008 


. PUTRC 


0005 


. RELES 


0001 


. RESRV 


0000 


. REWND 


0006 


. STCHB 


0012 


. STCHR 


0013 


. SUAX 


002C 


. SUBAM 


0017 


. SUBAX 


002D 


. SUBX 


002B 


. SUXBA 


002E 


. TBAX 


0025 


. TXBA 


0024 


. XBAX 


0026 


ACK 


0006 


AECHO 


FF5S 


BEL 


0007 


BKP1N$ 


FF54 


BRKPE* 


Ff-68 


BRKPT* 


FF24 


BS 


0008 


CAN 


0018 


CAS$ET 


FF67 


CBUFF? 


OOAE 


CBUFLS 


0050 


CBUFP* 


OOFE 


CDBDDA 


0008 


CDBDDF 


0006 


CDBHAD 


0004 


CDBIQC 


0000 


CDB! FN 


OOOC 


CDBSDA 


0002 


CDBVDT 


0007 


CDBWST 


OOOA 


CHFLG$ 


OllA 


CHKERR 


ES53 


CNACI* 


FCF4 


CR 


OOOD 


CUR ADR 


0006 


CURDRV 


0000 


DCl 


0011 


DC2 


0012 


DC3 


0013 


DC 4 


0014 


DD«CNS 


0004 


DD*FMC 


0001 


DD*INP 


0020 


DD*LOG 


0002 


DD*OCF 


0010 


DD«OUT 


0040 


DD*RES 


0080 


DD$RWD 


0008 


DEVDLM 


0023 


DFCLS* 


0020 


DID*DT 


OOOC 


DID«ID 


0000 


DID*NM 


0012 


DID*RB 


0026 


DID*RN 


OOOA 


DID*VN 


0008 


DIR*AT 


OOOC 


DIR$NM 


0000 


DIR*NU 


OOOE 


DIR*RB 


OOOA 


DIR«SX 


0008 


OLE 


0010 


DRVDLM 


003A 


DT*CLS 


0010 


DT*INP 


0080 


DT$NFF 


0004 


DT$OPI 


0001 


DT*OP0 


0002 


DT*OPP 


0000 


DT$QPU 


0003 


DT*OUT 


0040 


DT$Sia 


0020 


DT$TRU 


0008 


DV«INT 


0006 


DV$IO 


OOOC 


DVSOFF 


0003 


DV*ON 


0000 


DV$TRM 


0009 


E$FATL 


0080 


EM 


0019 


ENDOS$ 


0106 


ENDRV* 


Olio 


ENDSY* 


OlOA 


ENDUS* 


0108 


ENQ 


0005 


EOT 


0004 


ER*ACR 


0039 


ER*CRC 


0031 


ER*DAD 


0036 


ER«DMA 


0038 


ERSMRK 


0034 


ER*RDY 


0033 


ER$SEK 


0037 


ER*TIM 


0035 


ER*WRT 


0032 


ESC 


OOIB 


bIB 


0017 


ETX 


0003 


FAMDLM 


002A 


FD»CMP 


OOOS 


FD$CON 


0010 


FD«DFn. 


0040 


f-D«FMA 


0005 


FD*FMB 


0003 


FD*FMC 


0007 


FD«FMD 


0001 


FD*FML 


0002 


FD*FMU 


0000 


FD«SYS 


0020 


. FD*WRT 


0080 


FDINIT 


EB22 


FDSTAT 


0008 


FF 


OOOC 


FIR*VC 


FFF6 


F5 


OOIC 
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nuu&<y 


(V &qu< 


sue riie 


! l_iS1 


5DBA* 


0112 


GS 


OOID 


HT 


0009 


I*BU'FO 


OOOD 


I*CKSf1 


OOOE 


ISCLOS 


0008 


I$DEAL 


0017 


I*DF1 T 


0010 


I*DSPC 


0013 


I*DTYP 


OOOB 


I$DUPE 


0006 


I^EOF 


0009 


I*EOM 


OOOC 


I*FSPC 


0012 


I*FTYP 


OOOA 


I^IDEN 


0015 


I$IVDV 


0005 


I*NODV 


0001 


I*NOER 


0000 


I*NONM 


0007 


I^NORV 


0003 


I$NRDY 


0004 


I*RANG 


0011 


I«RECL 


0018 


I*RESV 


0002 


I$RIB 


0016 


I$SECS 


0019 


I*SSPG 


0014 


I*WRIT 


OOOF 


INCHNP 


F015 


lOCBLN 


0025 


lOCDBE 


0006 


lOCDBP 


0002 


IQCDBS 


0004 


lOCDEN 


OOIB 


rOCDTT 


0001 


I QCEDF 


0013 


lOCf-DF 


0017 


IQCSDW 


0008 


lOCLSN 


0011 


lOCLUN 


OOOA 


lOCMLS 


OOOB 


lOCNAM 


OOOB 


lOCRIB 


0015 


lOCSBE 


0O21 


lOCSBI 


0023 


laCSBP 


OOID 


IQCSBS 


OOIF 


lOCSDW 


OOOD 


lOCSLS 


OOOF 


lOCSTA 


0000 


lOCSUF 


0013 


IRQ*VC 


FFFB 


KYI*SV 


0104 


LDATA 


EBE4 


UDATAl 


EBF2 


LF 


OOOA 


LINES* 


FF92 


LIST 


EBCC 


LPINIT 


EBCO 


LSCTLN 


0005 


LU$RES 


0040 


MAID* 


F0F3 


MDOS* 


0100 


MD0S9* 


0001 


MDQSFS 


0000 


NAK 


0015 


MMI*VC 


FFFG 


NULL 


0000 


NUMSGT 


0003 


0CHAR5 


F9CF 


QPTDLM 


003B 


QSLQAD 


EBOO 


DUTCH 


FOIS 


PCRLF 


F021 


PDATA 


F024 


PRNTER 


ESSA 


RDCRC 


ES6F 


READPS 


E86D 


READSC 


ES69 


RESTOR 


EB75 


RETRY* 


0005 


REVS** 


0102 


RIB*LA 


0073 


RIB*LB 


0075 


RIB*SA 


007A 


RIB^SL 


0076 


RIBBA* 


oioe 


RS 


OOIE 


RUBQUT 


007F 


RWTEST 


EB72 


SB IT* 


FCFD 


SC*BB 


0017 


SC*CAT 


0001 


SC*CLS 


0004 


SC$DID 


oooo 


SC*DIR 


0003 


sc*Das 


0018 


SC*DRE 


0016 


SC*LDK 


0O02 


SC$«AX 


07D0 


SC$MXD 


0FA4 


SC*SIZ 


0080 


SC*TKD 


0034 


SC*TRK 


OOIA 


SCTCNT 


OOOB 


SEEK 


EB7a 


SI 


OOOF 


SIDES 


OOOD 


SO 


OOOE 


SOH 


0001 


SPACE 


0020 


STRSCT 


0001 


STX 


0002 


SUB 


OOIA 


SUFDLM 


002E 


SW2«VC 


FFF4 


SW3*VC 


FFF2 


SWI*SV 


0116 


SWI*UV 


0118 


SWI*VC 


FFFA 


SYEDCB 


0166 


SYERR* 


0114 


SYIOCB 


one 


SYN 


0016 


SYPOCB 


0141 


US 


OOIF 


VD*BIN 


0004 


VD*GDB 


0008 


VD*NHt- 


0080 


VD«SDA 


0010 


VERS** 


0100 


VT 


OOOB 


WRDDAM 


ES7E 


WRITSC 


EBa4 


WRTEST 


Ea7B 


WRVERF 


EBSl 


XPEED* 


FF02 


XREG*A 


FF20 


XREG*8 


FFIF 


XREGSC 


FF21 


XREG*D 


FFIE 


XRE5*P 


FF16 


XREG*S 


FF22 


XREG*U 


1-i-lS 


XREG4X 


FFIC 


XREG*Y 


f-hlA 


XSTAK* 


FFSF 
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MDOS 3. 00 Differences 



The folloujing appsndix contains s description of th# 
differences between MDOS 3.00 and prior versions of MDOS. 
The first part of the appendix contains those differences 
that may have an impact on user— written programs which were 
based on prior versions of MDOS. The second part of the 
appendix contains the enhancements that are apparent to the 
operator at the MDOS command level. These enhancements have 
been separated by the version number of MDOS in which they 
first appeared. All of the listed enhancements srs 
incorporated into MDOS 3. 00. 

J. 1 Impact of MDOS 3. 00 on Previous MDOS Programs 



MDOS version 3.00 accommodates both the single— sided and 
the double-sided diskettes* a foui — drive system* an<J multiple 
sector I/O. There are several items which as a result of 
these new features must be checked in all programs that have 
been fleveloped to use prior versions of MDOS. These items 
avs listed below. 

1. A program making explicit checks for logical unit 
numbers and 1 must be changed to accommodate the 
new numbers 2 and 3. 

2. A program referring to the maximum number of sectors 
on a diskette as 2000 (decimal) or 2002i or the 
symbol from the MDOS equate file (SC«MAX). must be 
changed to accommodate the possible larger diskette 
sizes that can be encountered with the double- sided 
systems. Once a diskette has been accessed, the 
diskette controller variable SIDES (location *000D) 
will have bit seven set or cleared to indicate the 
number of sides on the diskette. If bit seven is 
onei a single— sided diskette has been accessed. If 
bit seven is zero, a double-sided diskette has been 
accessed. This variable is set up properly in all 
versions of the MDOS diskette controller. 

A single-sided diskette can be accessed in a 
double-sided drive, however, a double-sided diskette 
cannot be accessed in a single— sided drive. 

A new symbol has been placed into the MDOS equate 
file that gives the maximum number of sectors on a 
double-sided diskette <SC$MXD). 
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The dou&ie-sided diskette has no unused sectors as do 
the single-sided diskettes* since an integral number 
of clusters exists. 

3. A program using the IOCS for diskette I/O must have 
the full IOCS configured as described in all MDOS 
manuals. This includes the until-nou-unused entry 
IQCSBI. 

4. A program using the IOCS for diskette I/O mill have 
to be changed if the sector buffer at the time of the 
.OPEN function call is not exactly an integral number 
of sectors. In previous versions of iiDQS» the sector 
size did not get checked until a subsequent I/O 
transfer was made (even though the entry parameters 
for the .OPEN call specified that lOCSBS and lOCSBE 
must be set up). 

5. A program using the IOCS for diskette I/O mill have 
to be changed if the sector buffer pointers CIOCSBS 
and lOCSBE) ars altered after the .OPEN function has 
been called. Since .OPEN sets lOCSBI to the same 
value as IDCSBE. moving the sector buffer requires 

• that all sector buffer pointers ( lOCSBSi lOCSBE.. and 

lOCSBI) be changed accordingly. 

6. A program accessing logical unit 1 without first 
using the system function . OPEN. . DIRSM, . CHANG, or 
. LOAD, will have to be changed so that the read head 
is restored before the unit is accessed. Previous 
versions of MDOS restored both logical units and 1 
each time the system initialized and each time the 
FIDOS command interpreter received cantrol; however, 
in MDOS 3.0 this is no longer true. Thus, the 
diskette controller firmware entry point RESTOR must 
be used to restore the head on the unit to be 
accessed if not using one of the above system 
functions <which do the restore themselves). The 
same is true if the program is to access units 2 or 3 
without first using one of these functions. 

7. A program that has been designating logical unit 
numbers in the diskette controller variable CURDRV 
(location $0000) as either a zero or a non-zero value 
(to access either unit or l)i will have to be 
changed so that the actual binary number is used 
instead. A non-zero value no longer guarantees that 
unit 1 will be accessed (physical I/O). 

8. If a program has been using the system function 
. ALUSM, the entry and exit conditions have been 
changed. Section 27. 5. 5 should be consulted for a • 
detailed description of the current entry and exit y 
c ond i tions. 
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9. Four new system functions have been provided for 
multiple sector physical diskette I/O. These new 
functions ars described in sections 25.2.7 and 
25.2.8. The existing system functions have not had 
their function numbers changed. 

10. The device independent I/O functions (Unified I/O 
functions in previous versions of MDOS manuals) for 
accessing the diskette have been enhanced with the 
multiple sector I/O capability. Noui/ a sector buffer 
can be larger than a single sector in order to 
minimize the number of diskette accesses that must be 
made (and therefore decrease the amount of time it 
takes a program to run). The following areas have 
been affected: 

IOCSBIj the IOCS sector buffer internal pointer, is 
now used. This pointer indicates the end of valid 
data within the user's sector buffer. It is 
initialized by the .OPEN function to point to the end 
of the sector buffer (lOCSBE). It is changed by the 
input functions to reflect the end of the valid data 
(if only using a single sector. lOCSBI will always be 
the same as lOCSBE). 

IOCSBEj the lOCB ending sector buffer pointer, still 
points to the last byte in the sector buffer; 
however, the sector buffer can be an integral number 
of sectors in length (one or more). 

No program modification will be required if a program 
is using record I/O and if the sector buffer stays in 
the same placej however. changing the size of the 
sector buffer should speed up the program. 

Programs using logical sector I/O will not require 
modification if only a single sector is accommodated 
by the buffer and if the sector buffer is always in 
the same place. Thus, existing programs should be 
minimally impacted. If the sector buffer changes 
locations (single sector size), then the lOCSBI entry 
must be adjusted along with the lOCSBE entry to 
reflect the end of the valid data within the sector 
buffer. 

If the user supplies a sector buffer larger than one 
sector, then he must realize that after a . SETLS 
function, he may have more sectors in the buffer than 
just the logical sector number requested. lOCLSN 
will be updated to point to the logical sector to be 
read next (incremented by the number of sectors that 
were read into the buffer). Upon return from the 
. GETLS call, lOCSBI will point to the last valid data 
byte within the sector buffer (less than or equal to 

Page J-03 



APPENDIX J M^°S 3.00 Differences 

lOCSBE). Thus. the user must check lOCSBI to 
determine the end of the data in the buffer and to 
calculate the number of sectors vsad. 

The . PUTLS function will write the logically 
contiguous sectors from IGCSBS through lOCSBI rrom 
the buffer to the file starting at lOCLSN. lOCMLS 
and lOCLSN are updated as expectedi and additional 
space may have been allocated. 

J. 2 Enhancements to MDQS 2. 20/2. 21 

^rsnrs -i -^rt ,..-.« ^oiaaearf ^.n siinnoT-fc the d US 1 mejnorvs map of 
the EXORciser II system. Other enhancements, however, uiere 
added to the MDOS commands at the same time. MDOS 2.21 is 
almost identical to MDOS 2.20. A change was implemented to 
aid in the proper sizing of contiguous memory during 
initialization when running with the USE module. 

1 A new command. ROLLOUT, was added to the standard 
command package. ROLLOUT allows the user to 
write blocks of memory to a diskette. 

2 A new command, ECHO, was added to the standard 
command package. ECHO allows users with an 
EXORciser II system to echo all console 
input/output to a line printer 

3. The Bootblock program may generate a new error 
message: EM. This message indicates that 
insufficient contiguous RAM exists in the system 
to load the resident MDOS. 

4. When MDOS 2.20 or 2.21 initializes via the EBOO; G 
or MDOS command to the debug monitor, it sizes 
memory using a technique that will not change the 
contents of memory. Thus, programs can be loaded 
above MDOS, the system reinitialized, and another 
program loaded with the first program image still 
intact in memory (first program must load above 
MDOS command interpreter and LOAD command). 

5. The FREE command can be invoked with the "L" 
option, causing its output to be directed to the 
line printer. 

6. The REPAIR command will default to drive zero if 
no logical unit number is specified. In 
addition, if' a file with a RIB error is not 
deleted, the user will not be able to update the 
CAT on diskette. A message is displayed to that 
effect during the last phase of the REPAIR 
process. 
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7. The COPY command allows users with an EXORtape 
paper tape reader to use that device. In 
addition* a user can provide his own device 
driver to be used by COPY for an input or output 
device. 

8. The LOAD command allows files to be loaded into 
the (Jser rlemory Map of an EXORciser II system 
that has the dual memory map configured. This is 
done with the '"J" option. The "V" option now 
allows programs to be loaded anywhere in memory 
(not below $20 or beyond *FFFFj however). In 
addition* the stack pointer is set to the EXbug 
stack area when the "V" option is specified. 

9. The DEL command will display the logical unit 
numbers along with the file names shown as being 
deleted or protected. In addition* the command 
line processing has been changed so that a null 
file name among a list of multiple file names is - 
invalid. 

10. The BINEX command generates an SO record 
containing the memory image file name and suffix. 

12. All standard error messages are displayed with a 
two— digit decimal reference number to allow them 
to be easily looked up in the error message 
chapter of the new MDOS manual. Most error 
messages are still, the same. However-. the 
wording was changed on several to make them more 
uniform. Also* the "AT nnnn" phrase that 
accompaijied many error messages has been removed 
to make the messages less cryptic. A new error 
message was added (as was a new error code) for 
sector I/O functions that are called with a 
sector buffer not 128 bytes in size. 

13. The EXBIN command ignores null records (carriage 
return only) if encountered in the EXbug— loadab le 
file. 

14. The EOT character (*04) which was output by the 
. PRINXi . DSPLX and . DSPLZ functions* is no longer 
written to the output device. 

15. The sequence of line feed, carriage return, null 
written to console and/or printer* has been 
changed to carriage return* line feed, null to 
eliminate the overprinting problem encountered on 
certain printers with an 80 character buffer when 
lines of 80 characters were printed. 

16. The FORMAT command has been upgraded to function 
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J. 3 Enhancements to MDQS 3. 00 



MDOS 3.00 was released to support EXDRdisk III 
( f our-drivesi double-sided). The other major enhancement was 
the addition of multiple sector I/O. The implementation of 
this enhancement has considerably reduced the amount of time 
it takes all MDOS commands to execute. Commands like LIST, 
MERGE. COPY, DOSGEN> and EDIT show the greatest increases in 
speed. The other enhancements are listed below. 
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BACKUP command has been modified to allow 
le-sided diskettes to ' be copied onto 
le-sided diskettes. A logical unit number 
ification can be entered on the command line 
allow copying diskettes from units other than 

to units other than one. The "R" option no 
er copies the LCAT from the source diskette, 
destination diskette's LCAT is initialized 
letely. The "V" option no longer terminates 
verify process if the system sectors in 
nder zero miscompare since the BREAK key can 
sed to abort the process at any time. 



The COPY command's "V" option will cause the 
miscompari sons to be displayed between sectors or 
records when verifying files. The "L" option can 
be used to direct this display to the line 
printer. The "B" option has been added to 
automatically verify files after the copy has 
completed (diskette-to-diskette copy only). 

The DOSGEN command has been changed allow logical 
unit number specifications 1-3. Either single- 
or double-sided diskettes can be DOSGENed. The 
write/read test has been changed to verify that 
the sectors locked out indeed have the deleted 
data mark written in them. The BREAK key is 
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sensed at times other than the file copy phase. 
Only one sector range can be locked out by the 
user. All input from the operator is entered on 
the same line as the input prompts. 

The FORMAT command has been changed to allow 
logical units other than number one to be 
formatted. Both single- and double-sided 
diskettes can be formatted. 

The REPAIR command has been changed so that it 

will work with logical units 0-3 and with single- 
and double— sided diskettes. In addition/ the 

version numbers between the resident MDOS and the 

ID sector ars compared and made the same. The 

version and revision numbers can no longer be 

changed by the operator. Several of the messages 
have been changed. 
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K. IOCS Input Parameter Sumraary 



The fciiowing appersdix contains a summary of the twelve 
different modes in which an IOCS can be used. The tables 
show the entries of an lOCB labelled on the left. Across the 
top of each table avB the names of the valid device 
independent I/O functions. Immediately underneath each I/O 
function mill be the letter "N" or "Y". The "N" indicates 
that the function cannot be used in the mode described by the 
title line under each table. A "Y" indicates that the 
function can be used. 

An "X" appears in those places where a given IOCS entry 
is required as an input parameter to the function in uhose 
column the "X" appears. At the bottom of each table* the 
values that must be placed into the IOCS entries are 
summarized. Periods in the table serve as place holders to 
shoui the columns. 
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IOCS ENTRY 

lOCSTA 

IQCDTT 

IDCDBP 

laCDBS 

lOCDBE 

lOCGDW 

lOCLUN 

lOCNAM/MLS 
/SDW 
/SLS 
/LSN 

lOCSUF/EOF 

lOCRIB 

lOCFDF 

lOCDEN 

lOCSBP/SIZ 

IQCSBS 

lOCSBE 

lOCSBI 
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Diskette Device — Record Procsssing/ Input (Existing File) 



lOCDTT = DTSCLS * DT*QP I 

laCGDW = DK 

lOCLUN = 0-3 

lOCNAM = File name of existing file 

lOCSUF = Suffix 

IDCSBS = Sector buffer start 

lOCSBE = Sector buffer end 

lOCDBS = Data buffer start 

lOCDBE = Data buffer end 
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I OCR IB 
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lOCSBE 
lOCSBI 
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Diskette Device — Record Procesing. Output (New file) 



of neuj file 



lOCDTT = DT*CLS + DT*OPO 

lOCGDW = DK 

lOCLUN = 0-3 

lOCNAM = File name 

lOCSUF = Suffix 

lOCFDF = FD«FMA or FD*FMB 

lOCSIZ = (Default size) 

lOCSBS = Sector buffer start 

lOCSBE = Sector buffer end 

lOCDBS = Data buffer start 

lOCDBE = Data buffer end 



plus other optional attributes 
or specific size 
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Diskette Device — Record Processing^ Update (New File) 



of new file 



lOCDTT = DT*CLS + DT$OPU 

IQCGDW = DK 

lOCLUN = 0-3 

IDCNAM = File name 

lOCSUF = Suffix 

lOCFDF = FD*FMA or FD«FMB 

lOCSIZ = (Default size) 

lOCSBS = Sector buffer start 

lOCSBE = Sector buffer end 

lOCDBS = Data buffer start 

IQCDBE = Data buffer end 



plus other optional attributes 
or specific size 
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Diskette Device 



Record Processing* Update (Existing file) 



lOCDTT = DT*CLS + DT*OPP 

lOCGDW = DK 

lOCLUN = 0-3 

lOCNAM = File name 

lOCSUF = Suffix 

lOCSBS = Sector buffer start 

lOCSBE = Sector buffer end 

lOCDBS = Data buffer start 

lOCDBE = Data buffer end 
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Diskette Device — Logical Sector Processing* Input 

(Existing <=ile) 



lOCDTT = DT4CLS + DT$OPI + DT$SIO 

IQCGDW = DK 

lOCLUN = 0-3 

lOCNAM = File name of existing file 

lOCSUF = Suffix 

lOCLSN = Starting logical sector number 

lOCSBS = Sector buffer start 

IQCSBE - Sector buffer end 



to be read 
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Diskette Device — Logical Sector Processing, Output 

(Neiu file) 

lOCDTT = DT$CLS + DT*OPO + DT$SIO 

lOCGDW = DK 

IDCLUN = 0-3 

IDCNAM = File name of new file 

IQCSUF = Suffix 

lOCFDF = Optional attributes 

lOCLSN = Starting logical sector number to be uiritten 

lOCSIZ = (Default size) or specific size 

lOCSBS = Sector buffer start 

lOCSBI = Sector buffer end 



Page K-07 



APPENDIX K 



lOCB Input Parameter Summary 



VALID GALL 
IOCS ENTRY 

IQCSTA 

lOCDTT 

lOCDBP 

lOCDBS 

IQCD5E 

lOCGDW 

lOGLUN 

lOCNAM/MLS 
/SDW 
/SLS 
/LSN 

lOCSUF/EOF 

I OCR IB 

lOCFDF 



R 

E 
S 
R 

y 



lOCDEN 

I0CSBP/SI2 

lOCSBS 

lOCSBE 

lOCSBI 



X 
X 



O G 
P E 
E T 
N R 
C 



X 
X 
X 
X 

X 



X 
X 
X 



p 
u 

T 
R 
G 



C R 

L E 

O L 

S E 

E S 



Q 

E 
T 
L 
S 



N 



N 



P 
U 
T 
L 
S 



R 

E 
W 
N 
D 



X X 

X X 
X 

' . . X 



Diskette Device — Logical Sector Processing, Update 

(Neui file) 



IDCDTT 
lOCODW 
lOCLUN 
lOCNAM 
lOCSUF 
lOCFDF 
lOCLSN 
lOCSIZ 

locsas 

lOCSBE 

IQCSBI 



o-F neui file 



DT*CLS + DT*OPU + DT«SID 

DK 

0-3 

File name 

Suffix 

Optional attributes 

Starting logical sector number 

(Default size) or specific size 

Sector buffer start 

Sector buffer end 

Sector buffer end 



u— on 
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Diskette Device — Logical Sector Processing, Update 

(Existing File) 

lOCDTT = DT«CLS + DT*OPP + DT«SID 

lOCGDW = DK 

lOCLUN = 0-3 

lOCNAM = File name of existing file 

lOCSUF = Suffix 

lOCLSN = Starting logical sector number 

lOCSBS = Sector buffer start 

lOCSBE = Sector buffer end 

lOCSBI = Sector buffer end 
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Non-diskette Device — Non-file Format. Input 

lOCDTT = DT*CLS + DT«NFF + DT^QPI 

lOCGDW = CN or CR 

laCLUN = 

lOCFDF = FD«FMA 

lOCSUF = Display prompt if device is CN 

IQCDBS = Data buffer start 

lOCDBE = Data buffer end 
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Non— diskette Device 



Non-file Format, Output 



lOCDTT = DT«CLS + DT«NFF + DT*OPO 

IQCGDW = LP, CN, or CP 

lOCLUN = 

IDCFDF = FD«F«A 

lOCDBS = Data buffer start 

lOCDBE = Data buffer end 
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Non-disketta Device — File Formati Input 



lOCDTT = DT«CLS + DT«OP I 

lOCGDW = CK 

lOCLUN = 

lOCDBS = Data buffer start (used for FDR processing) 

lOCDBE = Data buffer end 

lOCNAM = File name of existing file 

lOCSUF = Suffix 
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Non-diskette Device — File Format. Output 

lOCDTT = DT*CLS + DT*OPQ 

lOCGDW = CP 

lOCLUN = 

lOCDBS = Data buffer start (used for FDR processing) 

lOCDBE = Data buffer end 

lOCNAM = File name 

lOCSUF - Suffix 

lOCFDF = FD«FMA, FD*FMB, FD*FMCi or FD*FMD (only) 
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EXORdisk II/III System Specifications 



The following table lists the characteristics 
specifications of the EXORdisk II/III system. 



CHARACTERISTICS 



SPECIFICATIONS 



and 



POWER REQUIREMENTS 
AC Power 



iiU VaC> OU r\i. I J. -T rtiiiff 3 

110 Vac. 50 Hz, 3. 4 Amps 
220 Vac, 50 Hz/ 1. 8 Amps 



DC Power supplied by 
EXORciser 



+ 5 Vdc a 2. 75 Amps 
+12 Vdc @ 20 mAmps 
-12 Vdc @ 45 mAmps 



BUS INTERFACE SIGNALS 

Address, Control busses 

Data bus 



DISK-TO-CONTROLLER INTERFACE 
SIGNALS 

OPERATING TEMPERATURE 



TTL compatible 

Bi-directional, three state 
TTL compatible 

Positive true TTL compatible 



0-70 degrees Celsius 



PHYSICAL CHARACTERISTICS 
Disk Drive Unit 
Width 
Depth 
Height 
Weight 

Floppy Disk Controller 
Width 
Height 
Board thickness 



17. 75 inches 

23. 5 inches 

b. 96 inches 

4S pounds 



9. 75 inches 
5. 75 inches 
0. 06 inches 



CONNECTOR TYPES 

Bus Connector (PI) 



Stanford Applied Engineering 
SAC-43D/1-2 or equivalent 



Disk Drive Unit 
Connector (P2) 



AMP P/N 88393-7 or 
equi val ent 
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SUGGESTION/PROBLEM REPORT 



Motorola welcomes your comments on Its products and publications. Please use this form. 



To: Motorola Microsystems 
P.O. Box 20912 
Attention: Publications Manager 

Mail Drop M374 
Phoenix, Az. 85036 



Comments 
Product: _ 



Please Print 



Name 



CQmpa.ny 



Street 



City 

Hardware Support: 
Software Support: 



Manual: 



Title 



Division 



Mail Drop 



Phone Number 



State 



Zip 



(800) 528-1908 
(602) 962-3935 
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